From d5c08cdbfb2fa73f7f5f94ef19382955ce7eeff9 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 1 May 2021 01:18:46 +0900 Subject: Window.history を更新 (#525) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 2020/12/18 時点の英語版に同期 --- files/ja/web/api/window/history/index.html | 52 +++++++++++++----------------- 1 file changed, 23 insertions(+), 29 deletions(-) (limited to 'files/ja/web/api') diff --git a/files/ja/web/api/window/history/index.html b/files/ja/web/api/window/history/index.html index e7a7e8ebc7..f4f8789adf 100644 --- a/files/ja/web/api/window/history/index.html +++ b/files/ja/web/api/window/history/index.html @@ -1,56 +1,46 @@ --- -title: window.history +title: Window.history slug: Web/API/Window/history tags: - - Gecko + - API - HTML DOM - History API + - Property + - Reference - Window - - 要更新 translation_of: Web/API/Window/history --- -

{{ ApiRef }}

+
{{APIRef}}
-

読み取り専用プロパティWindow.historyは、{{domxref("History")}}オブジェクトへの参照を返します。{{domxref("History")}}はブラウザのセッション(今開いているタブやそのページが読み込まれているウィンドウで過去に訪れたページの履歴)を操作するインターフェースを提供します。

+

Window.history は読み取り専用プロパティで、 {{domxref("History")}} オブジェクトへの参照を返します。これはブラウザーのセッション履歴 (現在のページが読み込まれているタブまたはフレームで訪れたことがあるページ群) を操作するためのインターフェイスを提供します。

-

詳細や使用例については Manipulating the browser history をご覧ください。このページでは特にpushState()メソッドや replaceState()メソッドについてセキュリティの観点から詳しく解説がなされています。これらのメソッドは注意して使う必要があります。

+

詳細や使用例については、ブラウザーの履歴の操作をご覧ください。特に、このページでは {{domxref("History.pushState", "pushState()")}} メソッドと {{domxref("History.replaceState", "replaceState()")}} メソッドについて、使用する前に気を付けなければならないセキュリティ上の特性を説明しています。

-

{{ 英語版章題("Syntax") }}

+

例

-

構文

- -
var historyObj = window.history;
-
- -

{{ 英語版章題("Example") }}

- -

例

- -
history.back();     // 戻るボタンを押したのと同じ効果
-history.go(-1);     // history.back();と同等の効果が得られます
+
history.back();     // 戻るボタンを押すのと同等
+history.go(-1);     // history.back(); と同等
 

 
-
{{ 英語版章題("Notes") }}

-
-
注記

+
注

 
-
For top-level pages you can see the list of pages in the session history, accessible via the History object, in the browser's dropdowns next to the back and forward buttons.

+
最上位ページにおいて History オブジェクトを通してアクセスできるセッション履歴のページリストは、ブラウザーの「戻る」や「次へ」ボタンの隣にあるドロップダウンで確認することができます。

 
-
Historyオブジェクトはセッション履歴の他のページのURLへアクセスしようとする許可なきコードはセキュリティ上の理由から禁止しています。ただ、セッション履歴のあいだを行き来することは許可されています。

+
セキュリティ上の理由から、 History オブジェクトでは権限のないコードがセッション履歴内の他のページの {{glossary("URL", "URL")}} にアクセスすることを禁止していますが、セッション履歴の中を移動することは許可しています。

 
-
権限のないコードでセッション履歴を消去したり、戻る/進む操作を無効にしたりする方法はありません。このような機能をどうしても実現したいのならlocation.replace() メソッドを使うのがよいでしょう。このメソッドは現在のセッションを引数のURLに置き換えることができます。

+
権限のないコードから、セッション履歴を消去したり、前後への移動を無効にしたりする方法はありません。実現可能な最も近い解決策は、 {{domxref("Location.replace", "location.replace()")}} メソッドでセッション履歴の現在の項目を指定された URL で置き換えることです。

 
-
{{ 英語版章題("Specification") }}

-
-
仕様

+
仕様書

 
 
- 
+ 
-   
+   
+ 
+ 
@@ -63,3 +53,7 @@ history.go(-1);     // history.back();と同等の効果が得られます
   

   

    仕様
    状態コメント備考
   

   

    {{SpecName('HTML WHATWG', 'browsers.html#the-history-interface', 'The History interface')}}
    {{Spec2('HTML WHATWG')}}

  
 

+
+
ブラウザーの互換性

+
+
{{Compat("api.Window.history")}}

-- 
cgit v1.2.3-54-g00ecf