Firefox 关键字搜索结合 JavaScript 实现智能行程规划器_技术教程

本文介绍如何在 firefox 中创建支持动态日期、地址别名（如“h”代表家、“w”代表公司）和双参数输入的 javascript 书签脚本，用于快速调用荷兰 ns 铁路行程规划器。

Firefox 的关键字搜索（Keyword Search）本身仅支持单 %s 占位符的简单字符串替换，无法直接处理动态时间、条件逻辑或地址映射。但通过将其与 JavaScript 书签（Bookmarklet） 结合，并配合地址栏关键词触发，可实现功能远超原生限制的智能行程规划入口。

✅ 正确实现方式：使用 Bookmarklet + Keyword Search

将以下代码保存为书签，并为其设置一个快捷关键字（例如 ns），即可在地址栏输入 ns 后回车，触发交互式行程规划：

javascript:(function(){
    // ? 自定义地址别名（支持 Dutch/English 地名，按需修改）
    const home = 'Amsterdam Centraal';
    const work = 'Utrecht Centraal';

    // ? 构建基础参数对象（注意：NS 的 URL 使用 fragment hash，但参数实际在 hash 后的 query-like 字符串中）
    let params = {
        vertrek: '',
        vertrektype: 'treinstation',
        aankomst: '',
        aankomsttype: 'treinstation',
        type: 'vertrek',
        tijd: new Date().toISOString().slice(0, 16), // 格式：2025-06-15T09:32
        firstMileModality: 'PUBLIC_TRANSPORT',
        lastMileModality: 'PUBLIC_TRANSPORT',
        disabledTransportModalities: ''
    };

    // ? 获取出发地（支持别名）
    let startInput = prompt('出发地（输入 "h" 使用家地址）：', home);
    params.vertrek = startInput === 'h' ? home : startInput.trim();

    // ? 获取目的地（支持别名）
    let endInput = prompt('目的地（输入 "w" 使用公司地址）：', work);
    params.aankomst = endInput === 'w' ? work : endInput.trim();

    // ⚠️ 注意：NS 行程规划器使用 #/ 前缀 + 查询参数（非标准 query string），需手动拼接
    // 官方 URL 形式：https://www.ns.nl/reisplanner/#/?vertrek=...&aankomst=...
    const baseUrl = 'https://www.ns.nl/reisplanner/#/';
    const searchParams = new URLSearchParams(params).toString();
    const finalUrl = `${baseUrl}?${searchParams}`;

    // ? 跳转到生成的行程页
    location.href = finalUrl;
})();

? 使用步骤

新建书签：右键书签栏 → “添加网页书签”
名称：NS 行程规划器（任意）
网址（URL）：粘贴上方完整 javascript: 代码
设置关键字：在“关键字”字段填入 ns（或其他你喜欢的短词，如 tr）
使用：在地址栏输入 ns + 回车 → 弹出提示框 → 输入 h/w 或自定义车站名 → 自动跳转至带当前时间的 NS 规划页

? 关键注意事项

✅ 日期自动填充：new Date().toISOString().slice(0, 16) 精确输出 YYYY-MM-DDTHH:MM（符合 NS API 要求），无需手动计算时区（toISOString() 默认 UTC，NS 前端会自动适配本地时间显示）。
✅ 别名支持：h / w 在 prompt 中大小写敏感；若需忽略大小写，可改为 startInput.toLowerCase() === 'h'。
⚠️ NS URL 特性说明：该站点使用前端路由（#/），其 ? 后参数由 JS 解析，不能用 URLSearchParams 直接构造完整 URL 并跳转到 #/?... —— 但实测 location.href = 'https://.../#/?key=val' 完全兼容，浏览器正确传递 fragment 和 query。
⚠️ 空格与编码：用户输入中的空格会被 prompt 原样保留，NS 站点能正确处理（如 Amsterdam Centraal），无需手动 encodeURIComponent —— 因为 URLSearchParams 会自动编码值。
? 扩展建议：可增加更多别名（如 's' 代表学校）、记忆上次输入（localStorage）、或校验车站名格式（正则 /[A-Za-z\s]+Centraal$/）。

✅ 总结

原生 Firefox 关键字搜索不支持多参数、动态变量或逻辑判断，但借助 Bookmarklet + Keyword 组合，我们成功构建了一个轻量、可靠、用户友好的行程规划快捷入口：支持实时日期、地址别名、交互引导，且完全离线运行。无需插件、不依赖后端，是 Firefox 高级用户的典型生产力实践。