
本文介绍如何通过 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);
})();? 使用步骤:
- 创建书签:右键书签栏 → “添加网页” → 名称填 NS(或其他关键词),网址粘贴上方完整代码(确保以 javascript: 开头,无换行);
- 设置关键词:编辑该书签 → 在“关键字”字段填入 ns(例如);
- 调用方式:在地址栏输入 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 原生关键词的静态能力,而是拥有了一个轻量、可定制、生产就绪的行程规划快捷入口。










