chrome.history

refresh date: 2026-09-25 robots: noindex

説明

chrome.history API を使用して、ブラウザのアクセス済みページの記録を操作します。ブラウザの履歴で URL の追加、削除、クエリを行うことができます。履歴ページを独自のバージョンでオーバーライドするには、ページのオーバーライドをご覧ください。

権限

history

マニフェスト

履歴 API を使用するには、拡張機能のマニフェストで「history」権限を宣言する必要があります。次に例を示します。

{
  "name": "My extension",
  ...
  "permissions": [
    "history"
  ],
  ...
}

トランジションの種類

履歴 API は、遷移タイプを使用して、特定のアクセスでブラウザが特定の URL に移動した方法を記述します。たとえば、ユーザーが別のページのリンクをクリックしてページにアクセスした場合、遷移タイプは「リンク」になります。

次の表に、各遷移タイプを示します。

トランジションの種類説明
"typed"ユーザーがアドレスバーに URL を入力してこのページにアクセスしました。他の明示的なナビゲーション アクションにも使用されます。ユーザーが URL とはまったく異なる選択肢を選択した場合に使用される generated もご覧ください。
"auto_bookmark"ユーザーが UI の候補（メニュー項目など）からこのページにアクセスした。
"auto_subframe"サブフレームのナビゲーション。これは、トップレベル以外のフレームに自動的に読み込まれるコンテンツです。たとえば、広告を含む複数のフレームで構成されるページの場合、それらの広告 URL にこの遷移タイプが設定されます。ユーザーは、これらのページのコンテンツが別のフレームであることに気づいていない可能性があり、URL を気にしない可能性があります（manual_subframe も参照）。
"manual_subframe"ユーザーが明示的にリクエストし、戻る/進むリストに新しいナビゲーション エントリを生成するサブフレーム ナビゲーション。明示的にリクエストされたフレームは、自動的に読み込まれたフレームよりも重要である可能性があります。ユーザーは、リクエストされたフレームが読み込まれたことを気にしている可能性があるためです。
"generated"ユーザーはアドレスバーに入力し、URL とは異なるエントリを選択してこのページにアクセスしました。たとえば、一致した URL が Google 検索結果ページの URL であっても、ユーザーには「Google で ... を検索」と表示されることがあります。これは、ユーザーが入力した URL が表示される入力ナビゲーションとは異なります。キーワードもご覧ください。
"auto_toplevel"コマンドラインでページが指定されているか、スタートページである。
"form_submit"ユーザーがフォームに値を入力して送信しました。フォームでスクリプトを使用してコンテンツを送信する場合など、状況によっては、フォームを送信してもこの遷移タイプにならないことがあります。
「reload」ユーザーが、再読み込みボタンをクリックするか、アドレスバーで Enter キーを押して、ページを再読み込みしました。セッションの復元と閉じたタブを再度開く場合も、このトランジション タイプが使用されます。
"キーワード"URL は、デフォルトの検索プロバイダ以外の置換可能なキーワードから生成されました。keyword_generated もご覧ください。
"keyword_generated"キーワードで発生した訪問に対応します。キーワードもご覧ください。

例

この API を試すには、chrome-extension-samples リポジトリから history API のサンプルをインストールします。

型

HistoryItem

履歴クエリの結果を 1 つカプセル化するオブジェクト。

プロパティ

  • id

    文字列

    アイテムの一意の識別子。

  • lastVisitTime

    number 省略可

    このページが最後に読み込まれた時刻（エポックからのミリ秒単位）。

  • title

    文字列 省略可

    ページが最後に読み込まれたときのタイトル。

  • typedCount

    number 省略可

    ユーザーがアドレスを入力してこのページに移動した回数。

  • URL

    文字列 省略可

    ユーザーがアクセスした URL。

  • visitCount

    number 省略可

    ユーザーがこのページにアクセスした回数。

TransitionType

Chrome 44 以降

このサイトへの訪問の遷移タイプ（リファラーから）。

列挙型

「link」
ユーザーが別のページのリンクをクリックしてこのページにアクセスしました。

「typed」
ユーザーがアドレスバーに URL を入力してこのページにアクセスしました。これは、他の明示的なナビゲーション アクションにも使用されます。

"auto_bookmark"
ユーザーが UI の候補（メニュー項目など）からこのページにアクセスした。

「auto_subframe」
ユーザーが、前のページのフレームに読み込まれた広告など、リクエストしていないサブフレーム ナビゲーションを通じてこのページにアクセスしました。これらの操作では、必ずしも戻るメニューと進むメニューに新しいナビゲーション エントリが生成されるわけではありません。

「manual_subframe」
ユーザーがサブフレームで何かを選択してこのページにアクセスしました。

「generated」
ユーザーがアドレスバーに入力し、URL ではないエントリ（Google 検索の候補など）を選択してこのページにアクセスしました。たとえば、一致した URL が Google 検索の検索結果ページの URL であっても、ユーザーには「Google で ... を検索」と表示されることがあります。ユーザーがリンク先 URL を入力したり、表示したりしていないため、これは直接入力によるナビゲーションとは異なります。キーワード ナビゲーションにも関連しています。

「auto_toplevel」
コマンドラインでページが指定されたか、スタートページです。

"form_submit"
ユーザーがフォームに値を入力して送信し、このページにアクセスしました。すべてのフォーム送信でこの遷移タイプが使用されるわけではありません。

「reload」
ユーザーが再読み込みボタンをクリックするか、アドレスバーで Enter キーを押してページを再読み込みしました。セッションの復元と閉じたタブを再度開く場合にも、このトランジション タイプが使用されます。

「keyword」
このページの URL は、デフォルトの検索プロバイダ以外の置換可能なキーワードから生成されました。

"keyword_generated"
キーワード用に生成されたアクセスに対応します。

UrlDetails

Chrome 88 以降

プロパティ

  • URL

    文字列

    オペレーションの URL。history.search() の呼び出しから返される形式にする必要があります。

VisitItem

URL への 1 回のアクセスをカプセル化するオブジェクト。

プロパティ

  • id

    文字列

    対応する history.HistoryItem の固有識別子。

  • isLocal

    ブール値

    Chrome 115 以降

    このデバイスでセッションが開始された場合は true。別のデバイスから同期された場合は False。

  • referringVisitId

    文字列

    リファラーの訪問 ID。

  • transition

    TransitionType

    このサイトへの訪問の遷移タイプ（リファラーから）。

  • visitId

    文字列

    この訪問の固有識別子。

  • visitTime

    number 省略可

    このアクセスが発生した日時（エポックからのミリ秒数）。

メソッド

addUrl()

Promise 
chrome.history.addUrl(
  details: UrlDetails,
  callback?: function,
): Promise<void>

現在の時刻の履歴に、遷移タイプが「link」の URL を追加します。

パラメータ

  • 詳細

    UrlDetails

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () =& gt;void

戻り値

  • Promise<void>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

deleteAll()

Promise 
chrome.history.deleteAll(
  callback?: function,
): Promise<void>

履歴からすべてのアイテムを削除します。

パラメータ

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () =& gt;void

戻り値

  • Promise<void>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

deleteRange()

Promise 
chrome.history.deleteRange(
  range: object,
  callback?: function,
): Promise<void>

指定した期間内のすべてのアイテムを履歴から削除します。すべてのアクセスが範囲内に収まらない限り、ページは履歴から削除されません。

パラメータ

  • 範囲

    オブジェクト

    • endTime

      数値

      この日付より前に履歴に追加されたアイテム（エポックからのミリ秒単位）。

    • startTime

      数値

      この日付以降に履歴に追加されたアイテム（エポックからのミリ秒単位）。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () =& gt;void

戻り値

  • Promise<void>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

deleteUrl()

Promise 
chrome.history.deleteUrl(
  details: UrlDetails,
  callback?: function,
): Promise<void>

指定された URL のすべての履歴を削除します。

パラメータ

  • 詳細

    UrlDetails

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () =& gt;void

戻り値

  • Promise<void>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getVisits()

Promise 
chrome.history.getVisits(
  details: UrlDetails,
  callback?: function,
): Promise<VisitItem[]>

URL へのアクセスに関する情報を取得します。

パラメータ

  • 詳細

    UrlDetails

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (results: VisitItem[]) =& gt;void

戻り値

  • Promise<VisitItem[]>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

Promise 
chrome.history.search(
  query: object,
  callback?: function,
): Promise<HistoryItem[]>

クエリに一致する各ページの最終アクセス時刻を履歴から検索します。

パラメータ

  • クエリ

    オブジェクト

    • endTime

      number 省略可

      この日付より前にアクセスした結果に限定します。エポックからのミリ秒で表されます。

    • maxResults

      number 省略可

      取得する結果の最大数。デフォルトは 100 です。

    • startTime

      number 省略可

      この日付以降にアクセスした結果に限定します。エポックからのミリ秒で表されます。プロパティが指定されていない場合、デフォルトは 24 時間になります。

    • テキスト

      文字列

      履歴サービスに対するフリーテキスト クエリ。すべてのページを取得するには、このフィールドを空のままにします。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (results: HistoryItem[]) =& gt;void

戻り値

  • Promise<HistoryItem[]>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

イベント

onVisited

chrome.history.onVisited.addListener(
  callback: function,
)

URL にアクセスしたときに発生し、その URL の HistoryItem データを提供します。このイベントは、ページが読み込まれる前に発生します。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (result: HistoryItem) =& gt;void

onVisitRemoved

chrome.history.onVisitRemoved.addListener(
  callback: function,
)

1 つ以上の URL が履歴から削除されたときに発生します。すべてのアクセス履歴が削除されると、URL は履歴から削除されます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (removed: object) =& gt;void

    • 削除済み

      オブジェクト

      • allHistory

        ブール値

        すべての履歴が削除された場合は true。true の場合、URL は空になります。

      • URL

        string[] 省略可