• 视频
  • 直播
  • 凤凰卫视
  • 财经
  • 娱乐
  • 体育
  • 时尚
  • 汽车
  • 房产
  • 科技
  • 军事
  • 文化
  • 旅游
  • 佛教
  • 国学
  • 数码
  • 注册登录
    站内 输入关键词

    从空文件夹做出可访问页面并调用接口:网站代码入门步骤

    从空文件夹做出可访问页面并调用接口:网站代码入门步骤

    从空文件夹开始,准备代码编辑器和已安装 Node.js 的电脑,就能搭出一个本地网页,并让页面请求自己编写的接口。最短路径是:创建静态页面文件、用 Express 提供页面和接口、在浏览器检查返回结果。

    先准备项目并运行页面

    在终端确认 Node.js 与 npm 可用:运行 node -v 和 npm -v,能看到版本号即可。新建文件夹 website-demo,在其中初始化项目并安装 Express:

    npm init -y
    npm install express

    创建以下目录和文件。HTML 放页面结构,CSS 管外观,浏览器端 JavaScript 负责交互;server.js 则运行服务器并定义接口。

    website-demo/
      server.js
      public/
        index.html
        style.css
        app.js

    在 public/index.html 写入页面内容:

    <!doctype html>
    <html lang='zh-CN'>
    <head>
      <meta charset='UTF-8'>
      <meta name='viewport' content='width=device-width, initial-scale=1'>
      <title>我的第一个网页</title>
      <link rel='stylesheet' href='/style.css'>
      <script src='/app.js' defer></script>
    </head>
    <body>
      <main>
        <h1>网站代码入门</h1>
        <p id='message'>正在等待接口响应……</p>
      </main>
    </body>
    </html>

    在 public/style.css 加上基础样式,让页面结构和视觉设置分开:

    body {
      font-family: sans-serif;
      margin: 2rem;
      line-height: 1.6;
    }
    main {
      max-width: 40rem;
      margin: 0 auto;
    }

    定义接口契约,再让页面调用

    接口不是页面中的一个按钮,而是前后端约定好的请求方式和数据格式。本例约定:使用 GET 请求 /api/hello,成功时返回 HTTP 状态码 200,响应体是包含字符串字段 message 的 JSON。页面和服务器都按这份约定实现,才能正确交接数据。

    在项目根目录的 server.js 写服务端代码。静态文件由 Express 从 public 目录提供,接口路由单独处理:

    const express = require('express');
    const app = express();
    
    app.use(express.static('public'));
    
    app.get('/api/hello', (req, res) => {
      res.json({ message: '页面已成功调用接口' });
    });
    
    app.listen(3000, () => {
      console.log('请访问 http://localhost:3000');
    });

    再在 public/app.js 请求接口,并把返回字段显示到页面:

    const output = document.querySelector('#message');
    
    fetch('/api/hello')
      .then(response => {
        if (!response.ok) throw new Error(`HTTP ${response.status}`);
        return response.json();
      })
      .then(data => {
        output.textContent = data.message;
      })
      .catch(error => {
        output.textContent = '请求失败,请检查服务是否启动';
        console.error(error);
      });

    在项目根目录运行 node server.js,看到启动提示后,在浏览器打开 http://localhost:3000。页面应显示“页面已成功调用接口”。也可以直接访问 http://localhost:3000/api/hello,检查是否收到类似 {"message":"页面已成功调用接口"} 的 JSON。因为页面和接口由同一个本地服务器提供,请求使用相对路径即可,不需要额外配置跨域。

    出错时按现象定位

    • 页面打不开:确认终端仍在运行服务器,并且浏览器地址使用 localhost:3000。若终端显示端口已被占用,把 app.listen(3000 中的端口改为其他空闲端口,同时访问对应的新地址。
    • 显示“请求失败”:打开浏览器开发者工具的 Network(网络)面板,查看 /api/hello 请求的状态码。404 通常意味着路径或路由没有对应上;连接失败则先检查服务是否仍在运行。
    • 页面显示不了内容:确认文件名和目录位置一致,并确保从项目根目录启动服务。比如 index.html 应在 public 中,而不是和 server.js 放在同一层。
    • 接口能打开但页面报错:检查响应是否为 JSON,以及字段名是否仍是 message。如果服务端把字段改成 text,前端也必须同步改为读取 data.text;这正是接口契约需要双方遵守的原因。

    在 Windows、macOS 或 Linux 上,目录结构和上述命令基本相同;若安装依赖时报错,先确认终端当前目录是项目根目录,再检查 Node.js 与 npm 是否能输出版本。代码修改后,页面文件通常刷新即可看到变化;修改服务器路由后,应停止并重新运行 node server.js。

    从这个小项目继续学什么

    完成示例后,可以尝试增加一个接口字段,例如返回 time,再让页面显示它;改动时同时更新服务端响应和前端读取逻辑。接着学习表单提交、请求参数、错误状态码和数据校验。排查问题时先分清页面文件、浏览器脚本和服务器接口各自负责什么,通常比把全部代码写进一个文件更容易定位原因。页面展示接口数据时使用 textContent,不要把未经处理的内容直接当作 HTML 插入;账号密钥也不应写进公开给浏览器的前端代码。

    [责任编辑:潘美玲]

    为您推荐