大网数据广告活动
Web 标准与前端开发

NavigateEvent:NavigateEvent() 构造函数

· 52CE 我爱测

`NavigateEvent()`** 构造函数创建一个新的 NavigateEvent 对象实例。

Navigation API

NavigateEvent() 构造函数创建一个新的 NavigateEvent 对象实例。

语法

new NavigateEvent(type, init)

参数

  • type
    • : 表示事件类型的字符串。
  • init
    • : 一个对象,除了 Event/Event 中定义的属性之外,还具有以下属性:
      • canIntercept
        • : 定义是否可以拦截导航的布尔值(例如,你不能拦截跨源导航)。默认为 false。
      • destination
        • : 一个 NavigationDestination 对象,代表要导航到的目标。
      • downloadRequest
        • : 在下载导航的情况下(例如,具有 download 属性的 a 或 area 元素),请求下载的文件的文件名。默认为 null。
      • formData
        • : FormData 对象,表示在 POST 表单提交的情况下提交的数据。默认为 null。
      • hashChange
        • : 定义导航是否为片段导航(即导航至同一文档中的片段标识符)的布尔值。默认为 false。
      • hasUAVisualTransition
        • : 布尔值,定义用户代理在调度此事件之前是否已为此导航执行视觉可见的过渡。默认为 false。
      • info
        • : 启动导航操作传递的 info 数据值(例如 Navigation.back() 或 Navigation.navigate())。
      • navigationType
        • : 导航类型。可能的值为——push、reload、replace 和 traverse。默认为 push。
      • signal
        • : AbortSignal,如果导航被取消(例如,用户按下浏览器的“停止”按钮,或者另一个导航启动并因此取消正在进行的导航),它将中止。
      • userInitiated
        • : 布尔值,定义导航是否由用户发起(例如,通过单击链接、提交表单或按浏览器的“后退”/“前进”按钮)。默认为 false。

返回值

一个新的 NavigateEvent 对象。

示例

开发人员不会手动使用此构造函数。当由于 Navigation.navigate_event 事件触发而调用处理器时,会构造一个新的 NavigateEvent 对象。

navigation.addEventListener("navigate", (event) => {
  // 如果此导航不应被拦截,则提前退出,例如,如果导航是跨源的,或者是下载请求
  if (shouldNotIntercept(event)) {
    return;
  }

  const url = new URL(event.destination.url);

  if (url.pathname.startsWith("/articles/")) {
    event.intercept({
      async handler() {
        // URL 已更改,因此在获取新内容时显示占位符,例如旋转图标或加载页面
        renderArticlePagePlaceholder();

        // 获取新内容并在准备就绪时显示
        const articleContent = await getArticleContent(url.pathname);
        renderArticlePage(articleContent);
      },
    });
  }
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。