You need to enable JavaScript to run this app. Node.js如何向EJS页面传递自定义变量并在页面脚本中使用
优惠活动
大模型
产品
解决方案
定价
更多

Node.js如何向EJS页面传递自定义变量并在页面脚本中使用

服务端变量传入EJS内嵌脚本的正确实现方案

未定义问题的核心触发原因

绝大多数场景下的未定义报错,都是因为没有正确经过EJS的模板渲染流程完成值注入:EJS的变量渲染逻辑只在服务端完成HTML字符串拼接时生效,原生写在<script>标签里的裸JS变量名,不会被自动替换为服务端传入的值,自然会被前端JS识别为未定义的标识符。

具体实现步骤

1. Node.js服务端传值逻辑

以Express框架的路由处理为例,在调用EJS渲染方法时,将需要传递的变量作为第二个参数的键值对传入:

// 路由处理逻辑
app.get('/target-page', (req, res) => {
  // 定义服务端需要传递给模板的变量
  const newOne = "Yes";
  // 渲染EJS模板,通过上下文对象传入变量
  res.render('target.ejs', {
    // 键名就是模板渲染时可访问的变量名
    newOne: newOne
  });
});

注意:不要将服务端密钥、数据库凭证这类敏感信息放入模板上下文中,这类值会在渲染后直接暴露在前端页面源码中。

2. EJS模板内的脚本读取逻辑

在EJS页面内嵌的<script>标签中,不能直接读取裸的newOne标识符,需要先通过EJS的输出语法把变量值序列化为合法的前端JS值,再赋值给前端作用域的变量:

<!-- EJS模板页面结构 -->
<html>
  <body>
    <!-- 页面静态HTML内容 -->
    <script>
      // 用JSON.stringify将服务端变量转为合法的JS字面量,通过EJS无转义输出标签注入到前端作用域
      // 加上空值兜底,避免部分路由未传参时触发模板渲染错误
      const clientNewOne = <%- JSON.stringify(newOne ?? "") %>;

      // 完成值注入后,即可正常做值判断执行对应逻辑
      if (clientNewOne === "Yes") {
        // 匹配到对应值后的业务逻辑
        console.log("已识别到newOne标识为Yes");
      }
    </script>
  </body>
</html>

高频错误写法对照

  • 错误写法1:直接在脚本里使用裸变量判断,比如if (newOne === "Yes"),没有通过EJS输出标签做值替换,渲染完成后的HTML中这行代码无任何改动,前端找不到对应的newOne变量,直接触发未定义报错。
  • 错误写法2:使用带HTML转义的EJS输出标签<%= newOne %>注入字符串值,会把字符串值渲染为不带引号的裸标识符,比如将"Yes"渲染成const clientNewOne = Yes,JS会将Yes识别为未定义的变量,同样触发报错。
  • 错误写法3:未做值兜底,当部分路由没有在模板上下文中传入newOne键时,EJS会直接抛出模板渲染错误,导致页面无法正常加载。

内容的提问来源于stack exchange,提问作者SpringerJerry

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 05:06:04