这篇翻译不完整。请帮忙从英语翻译这篇文章。
使用 history API与浏览器历史记录进行交互。
注意：下载也被当做一个 HistoryItem 对象。因此，history.onVisited等事件也会被下载所触发。
浏览器历史记录是对用户所访问的页面按时间顺序进行的记录和保存。history API 可以帮你实现以下功能：
然而，用户可能多次访问单个页面，因此API中有访问集合“visits”的概念。所以，该API还可以做如下使用：
使用该API之前，扩展程序必须在其 manifest.json 文件中获取history的许可。
类型
history.TransitionType- 描述浏览器如何转到特定页面。
history.HistoryItem-
提供浏览器历史记录中单个特定页面的详细信息。
history.VisitItem-
描述对一个页面的单次访问。
方法
history.search()- 在浏览器历史记录中查找符合给定条件的
history.HistoryItem history.getVisits()- 获取指定页面的访问集信息。
history.addUrl()- 为浏览器历史记录添加一个指定页面的访问。
history.deleteUrl()- 移除浏览器历史记录中所有对指定URL的访问。
history.deleteRange()- 移除指定时间段内对用户指定页面的访问。
history.deleteAll()- 移除浏览器历史记录中的所有访问。
事件
history.onTitleChanged-
当用户访问的页面标题被记录时触发。
history.onVisited- 每次用户访问页面时会触发，并提供该页面的
history.HistoryItem数据。 history.onVisitRemoved-
当一个URL被彻底从浏览器历史记录中移除时触发。
浏览器兼容性
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Chrome | Edge | Firefox | Firefox for Android | Opera | |
|---|---|---|---|---|---|
HistoryItem | Yes | No | 49 | No | Yes |
TransitionType | Yes | No | 50 | No | Yes |
VisitItem | Yes | No | 50 | No | Yes |
addUrl | Yes | No | 49 | No | Yes |
deleteAll | Yes | No | 49 | No | Yes |
deleteRange | Yes | No | 49 | No | Yes |
deleteUrl | Yes | No | 49 | No | Yes |
getVisits | Yes | No | 50 | No | Yes |
onTitleChanged | No | No | 55 | No | No |
onVisitRemoved | Yes | No | 50 | No | Yes |
onVisited | Yes | No | 50 * | No | Yes |
search | Yes | No | 49 | No | Yes |
Example extensions
致谢
该 API 基于Chromium的chrome.history API。该文档由Chromium代码中的history.json衍生而来。
微软 Edge 兼容性数据由微软公司提供并包含在如下证书中—— Creative Commons Attribution 3.0 United States License.
// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.