You need to enable JavaScript to run this app. AEM 6.5 调用JS Use API传参失败及window.location不生效问题
优惠活动
大模型
产品
解决方案
定价
更多

AEM 6.5 调用JS Use API传参失败及window.location不生效问题

问题根因说明

JS Use API 是 AEM 服务端执行的脚本,运行环境没有浏览器的window对象,所以window.location无法使用是正常情况。你遇到的传参报错可以按下面步骤逐一排查:

排查与解决步骤

  • 第一步:修正 HTL 表达式语法
    现有 HTML 代码的最大问题是没有将资源路径与参数放在 HTL 的${}表达式包裹范围内,导致系统直接把整段字符串当作 JS 文件路径解析,自然报错。
    错误写法:
    <sly data-sly-use.item="'myfile.js' @ url=value">
    
    正确写法:
    <sly data-sly-use.item="${'myfile.js' @ url=value}">
    
  • 第二步:验证传入参数value的有效性
    可以先替换为写死的测试值排除参数本身为空的问题:
    <sly data-sly-use.item="${'myfile.js' @ url='https://example.com/test'}">
    
    也可以直接传入 AEM 内置的当前页面 URL 变量,无需自己额外定义:
    <sly data-sly-use.item="${'myfile.js' @ url=currentPage.url}">
    
  • 第三步:检查 JS 代码语法问题
    示例中的/other code/不是合法的 JS 注释格式,会直接抛出语法错误。JS 注释需要符合以下规范:
    // 单行注释用双斜杠
    /* 多行注释用斜杠加星号包裹 */
    
    完整的合法 JS Use API 示例:
    "use strict";
    use(function () {
      var url = this.url;
      // 其他业务逻辑
      // 要返回给HTL调用的属性需要放在return对象里
      return {
        url: url
      };
    });
    
  • 第四步:验证 JS 文件路径正确性
    data-sly-use中引用的 JS 文件路径是相对于当前 HTL 文件的相对路径,如果 JS 文件不在同级目录,需要补全路径,比如 JS 放在当前目录的 js 文件夹下,写法为:
    <sly data-sly-use.item="${'./js/myfile.js' @ url=value}">
    

更优方案:直接在服务端JS获取当前URL

无需从 HTL 传参,JS Use API 运行环境内置了request对象,可以直接获取当前请求的完整URL:

"use strict";
use(function () {
  // 直接获取当前请求的完整URL
  var currentUrl = request.getRequestURL().toString();
  return {
    currentUrl: currentUrl
  };
});

后续在 HTL 里直接用${item.currentUrl}就能拿到对应值。

最终定位技巧

如果以上步骤都没解决,直接查看 AEM 服务端的error.log日志,里面会打印具体的错误类型(文件找不到/JS语法错误/参数异常等),可以快速定位问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.18 13:15:02