开发Edge扩展时如何通过chrome.history获取完整历史记录？

问题原因 #

chrome.history.search() 接口默认仅返回最近的有限数量记录（通常为100条左右），且未指定时间范围时，查询范围会被限制在浏览器本次启动后的时间段内，导致重启后查询结果为空。单次调用的maxResults设置无法突破浏览器的单次返回上限，必须通过分页查询结合时间范围参数才能获取完整历史。

解决方案 #

要获取全部历史记录，需满足两个核心条件：

• 明确指定时间范围：将startTime设为0（对应Unix纪元起始时间，即1970年1月1日），确保覆盖所有历史记录。
• 分页迭代查询：每次调用后，用上一批结果中最早的lastVisitTime作为下一次查询的endTime，循环调用直到返回空数组，说明已获取全部记录。

代码实现 #

替换你现有的displayHistory函数，改为递归分页查询的版本：

function displayHistory(items, filter, main) {
    items.processingDone = false;
    undisplayAll(items, main);
    // 存储所有历史记录的数组
    let allHistory = [];
    // 初始查询：从纪元开始，无结束时间限制
    function fetchBatch(endTime = Infinity) {
        chrome.history.search(
            {
                text: filter,
                maxResults: 100, // 浏览器单次返回的合理上限，通常为100条
                startTime: 0, // 从最早的记录开始查询
                endTime: endTime // 上一批的最早时间作为本次的结束时间
            },
            (historyBatch) => {
                if (historyBatch.length === 0) {
                    // 无更多记录，渲染全部结果
                    for (const item of allHistory) {
                        displayItem(items, item, main);
                    }
                    items.processingDone = true;
                    return;
                }
                // 合并当前批次记录到总数组
                allHistory = [...allHistory, ...historyBatch];
                // 获取当前批次最早的记录时间，作为下一次查询的结束时间
                const earliestTime = Math.min(...historyBatch.map(item => item.lastVisitTime));
                // 递归查询下一批（减1避免重复获取最后一条记录）
                fetchBatch(earliestTime - 1);
            }
        );
    }
    // 启动首次查询
    fetchBatch();
}

关键说明 #

• startTime: 0：强制查询从浏览器存在的最早记录开始，而非默认的近期范围。
• 分页逻辑：通过逐步缩小查询的时间范围，分批获取更早的历史记录，直到没有新结果返回。
• maxResults设置：浏览器对单次调用的返回数量有内部限制（通常为100），设置为100是更稳妥的选择，过高的数值不会生效。

内容的提问来源于stack exchange，提问作者YurichBRO