Node.js结合EJS如何将渲染数据传递给独立前端JS文件
独立静态JS文件接入后端EJS传递数据的可落地方案
核心前提说明
独立JS文件如果是通过静态资源服务直接从磁盘返回的,本身不会经过EJS模板渲染流程,直接在文件里写EJS语法是不会生效的,所有方案都是围绕打破这个限制设计的。
方案一:全局挂载数据,独立JS从window读取(最常用,改动最小)
这个方案不需要调整原有静态资源服务的配置,90%的场景都适用:
- 第一步:在
dashboard.ejs的</body>标签前,在引入独立JS文件的代码之前,插入一段内联EJS脚本,把后端传入的用户数据安全序列化后挂载到浏览器全局对象上:<script> // 对序列化后的数据做基础转义,避免XSS和标签闭合问题 const safeUserData = <%- JSON.stringify(user) .replace(/</g, '\\u003c') .replace(/>/g, '\\u003e') %>; window.SERVER_BUNDLE = safeUserData; </script> <!-- 再引入原有的独立JS文件,建议加defer保证加载顺序 --> <script src="/dashboard/scripts/script.js" defer></script> - 第二步:在你的独立
script.js文件中,直接从全局对象读取数据赋值给目标变量即可:// script.js 内部代码 const ext = window.SERVER_BUNDLE; // 后续所有JS逻辑正常编写即可 - 注意点:
- 输出序列化JSON时必须用
<%- %>(不转义HTML字符),不要用<%= %>(会把特殊字符转义导致JSON解析失败) - 加
defer属性可以保证内联脚本先执行完成,避免独立JS加载时读不到全局变量导致undefined
- 输出序列化JSON时必须用
方案二:将独立JS改造为EJS模板,走路由渲染流程
如果不想在全局window上挂多余变量,可以把JS文件从静态资源目录移到模板目录,专门走路由渲染流程返回:
- 第一步:把原有磁盘上的
/public/dashboard/scripts/script.js文件移动到模板目录views/dashboard/下,重命名为script.ejs,文件内部直接写入需要接收变量的代码:// views/dashboard/script.ejs 文件内容 const ext = <%- JSON.stringify(user) .replace(/</g, '\\u003c') .replace(/>/g, '\\u003e') %>; // 后续原有JS逻辑保持不变 - 第二步:新增专门的路由处理这个JS文件的请求,替换原来静态资源对这个路径的映射,同时保留原有鉴权逻辑:
router.get('/scripts/script.js', isAuth, function (req, res) { User.find({ id: req.user[0].id }).populate("tweets").populate("tags").exec(function (err, user) { // 必须设置正确的响应头,否则浏览器会把返回内容当HTML解析 res.setHeader('Content-Type', 'application/javascript'); res.render("dashboard/script", { user: user }); }); }); - 注意点:这个方案一定要给路由加上和原页面一致的鉴权中间件,避免未登录用户直接请求JS接口拿到敏感的用户数据。
常见踩坑提醒
- 不要直接在公网静态目录下的JS文件里写EJS语法,静态资源服务会直接返回文件原文,不会做模板解析,最终会导致浏览器JS语法报错
- 序列化嵌入页面的JSON时一定要做特殊字符转义,避免用户输入内容包含
</script>字样直接闭合标签,引发XSS安全问题
内容的提问来源于stack exchange,提问作者user14036065
相关产品推荐
相关产品推荐

