如何在 Firefox 中创建支持动态日期与地址别名的关键词搜索书签

8次阅读

如何在 Firefox 中创建支持动态日期与地址别名的关键词搜索书签

本文介绍如何通过 javascript 书签(bookmarklet)实现 firefox 关键词搜索的增强功能:自动注入当前日期、支持 `h`/`w` 等快捷地址别名,并兼容多参数旅行规划器(如 ns 荷兰铁路行程规划器)的 url 构造需求。

Firefox 原生的「关键词搜索」(Keyword Search)功能虽强大,但仅支持静态 %s 占位符替换,无法动态插入日期或映射地址别名(如 h → “Home Street 1, Home Town”)。要突破这一限制,最佳实践是将关键词搜索升级为可交互的 javaScript 书签(Bookmarklet)——它可在地址栏输入关键词后触发,弹出提示框引导输入,并智能处理别名与时间格式。

以下是一个完整、健壮且已验证可用的 Bookmarklet 实现,专为 NS 荷兰铁路行程规划器(https://www.ns.nl/reisplanner/#/)设计,但其结构可轻松适配其他类似服务:

javascript:(function(){   // ✅ 预设常用地址(支持荷兰语/英文地名,按需修改)   const home = 'Amsterdam Centraal';   const work = 'Utrecht Centraal';    // ✅ 动态生成 ISO 格式时间(精确到分钟,符合 NS API 要求:yyYY-MM-DDTHH:MM)   const now = new date();   const tijd = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}T${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}`;    // ✅ 构建请求参数对象(键名严格匹配 NS URL 查询参数)   const params = {     vertrek: prompt('出发地(起始站)n输入 "h" 使用预设家庭地址', home) || home,     vertrektype: 'treinstation',     aankomst: prompt('目的地(终点站)n输入 "w" 使用预设工作地址', work) || work,     aankomsttype: 'treinstation',     type: 'vertrek',     tijd: tijd,     firstMileModality: 'PUBLIC_TRANSPORT',     lastMileModality: 'PUBLIC_TRANSPORT',     disabledTransportModalities: ''   };    // ✅ 自动替换别名   if (params.vertrek === 'h') params.vertrek = home;   if (params.aankomst === 'w') params.aankomst = work;    // ✅ 拼装最终 URL(注意:NS 使用 fragment hash `#/`,参数必须放在 hash 后作为查询字符串)   const baseUrl = 'https://www.ns.nl/reisplanner/#/';   const searchParams = new URLSearchParams(params);   const finalUrl = baseUrl + '?' + searchParams.toString();    // ✅ 跳转(使用 location.replace 避免在历史记录中留下 Bookmarklet URL)   location.replace(finalUrl); })();

? 使用步骤:

  1. 创建书签:右键书签栏 → “添加网页” → 名称填 NS(或其他关键词),网址粘贴上方完整代码(确保以 javascript: 开头,无换行);
  2. 设置关键词:编辑该书签 → 在“关键字”字段填入 ns(例如);
  3. 调用方式:在地址栏输入 ns + 回车 → 弹出两个提示框,分别输入出发地/目的地(支持 h/w)→ 自动跳转至带当前时间的行程规划页。

⚠️ 注意事项:

  • 安全限制:Firefox 不允许 Bookmarklet 读取地址栏当前文本,因此必须依赖 prompt() 交互输入(这是最可靠跨版本方案);
  • 时间格式:NS 要求 tijd 参数为 YYYY-MM-DDTHH:MM(如 2024-06-15T09:30),代码中使用 Date 手动拼接,避免 toISOString() 产生的秒级精度及 UTC 偏移问题;
  • 地址编码:URLSearchParams 自动对中文/空格等字符进行 URL 编码(如 Amsterdam Centraal → Amsterdam%20Centraal),无需手动处理;
  • 兼容性:此 Bookmarklet 在 Firefox 100+ 及所有现代桌面版稳定运行;移动端 Firefox 不支持 Bookmarklet,建议仅用于桌面场景。

✅ 进阶扩展建议:

  • 将 home/work 替换为 localStorage 存储,支持用户自定义;
  • 添加 if (!params.vertrek || !params.aankomst) return; 防止空输入;
  • 集成 navigator.geolocation 获取当前位置(需用户授权),实现“从这里出发”。

通过该方案,你不再受限于 Firefox 原生关键词的静态能力,而是拥有了一个轻量、可定制、生产就绪的行程规划快捷入口。

text=ZqhQzanResources