From 4aaee0a1710f4df99bf4e07fa2ae8986b6219c62 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 14 Sep 2021 23:03:12 +0900 Subject: Mozilla/Add-on-url以下の文書内のリンクURLを正規化 (#2365) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - /en-US へのリンクを /ja へのリンクに修正 - /ja が付いていないものに /ja を付加 - MDN内のリンクが完全URLの場合、 /ja/docs からのURLに修正 --- .../add_a_button_to_the_toolbar/index.html | 2 +- .../add-ons/webextensions/api/alarms/index.html | 2 +- .../add-ons/webextensions/api/bookmarks/index.html | 4 +-- .../webextensions/api/bookmarks/search/index.html | 2 +- .../webextensions/api/browseraction/index.html | 2 +- .../api/browseraction/onclicked/index.html | 2 +- .../webextensions/api/browsersettings/index.html | 2 +- .../api/browsingdata/removecache/index.html | 4 +-- .../api/clipboard/setimagedata/index.html | 8 ++--- .../add-ons/webextensions/api/commands/index.html | 4 +-- .../webextensions/api/contentscripts/index.html | 4 +-- .../api/contentscripts/register/index.html | 4 +-- .../api/contextualidentities/index.html | 2 +- .../webextensions/api/cookies/cookie/index.html | 2 +- .../add-ons/webextensions/api/cookies/index.html | 2 +- .../api/devtools/inspectedwindow/eval/index.html | 2 +- .../api/devtools/inspectedwindow/index.html | 2 +- .../webextensions/api/devtools/network/index.html | 4 +-- .../api/downloads/download/index.html | 6 ++-- .../add-ons/webextensions/api/downloads/index.html | 2 +- .../webextensions/api/extensiontypes/index.html | 2 +- .../add-ons/webextensions/api/find/find/index.html | 6 ++-- .../add-ons/webextensions/api/history/index.html | 6 ++-- .../api/i18n/detectlanguage/index.html | 4 +-- .../api/identity/getredirecturl/index.html | 2 +- .../add-ons/webextensions/api/identity/index.html | 2 +- .../add-ons/webextensions/api/idle/index.html | 2 +- .../mozilla/add-ons/webextensions/api/index.html | 8 ++--- .../webextensions/api/management/index.html | 2 +- .../add-ons/webextensions/api/menus/index.html | 4 +-- .../api/notifications/create/index.html | 6 ++-- .../webextensions/api/pageaction/index.html | 2 +- .../webextensions/api/permissions/index.html | 2 +- .../add-ons/webextensions/api/proxy/index.html | 4 +-- .../webextensions/api/runtime/onmessage/index.html | 8 ++--- .../api/runtime/openoptionspage/index.html | 4 +-- .../api/runtime/sendmessage/index.html | 6 ++-- .../add-ons/webextensions/api/sessions/index.html | 4 +-- .../add-ons/webextensions/api/storage/index.html | 2 +- .../webextensions/api/storage/local/index.html | 2 +- .../api/storage/storagearea/clear/index.html | 4 +-- .../api/storage/storagearea/get/index.html | 6 ++-- .../storage/storagearea/getbytesinuse/index.html | 4 +-- .../api/storage/storagearea/remove/index.html | 2 +- .../api/storage/storagearea/set/index.html | 6 ++-- .../webextensions/api/storage/sync/index.html | 2 +- .../api/tabs/capturevisibletab/index.html | 4 +-- .../webextensions/api/tabs/create/index.html | 8 ++--- .../webextensions/api/tabs/duplicate/index.html | 4 +-- .../api/tabs/executescript/index.html | 8 ++--- .../add-ons/webextensions/api/tabs/get/index.html | 4 +-- .../add-ons/webextensions/api/tabs/index.html | 8 ++--- .../webextensions/api/tabs/remove/index.html | 4 +-- .../add-ons/webextensions/api/tabs/tab/index.html | 12 ++++---- .../add-ons/webextensions/api/topsites/index.html | 2 +- .../webextensions/api/webnavigation/index.html | 8 ++--- .../webextensions/api/webrequest/index.html | 4 +-- .../api/windows/windowstate/index.html | 2 +- .../chrome_incompatibilities/index.html | 24 +++++++-------- .../webextensions/content_scripts/index.html | 16 +++++----- .../content_security_policy/index.html | 8 ++--- .../index.html | 6 ++-- .../extending_the_developer_tools/index.html | 2 +- .../implement_a_settings_page/index.html | 6 ++-- files/ja/mozilla/add-ons/webextensions/index.html | 4 +-- .../webextensions/internationalization/index.html | 2 +- .../webextensions/manifest.json/author/index.html | 2 +- .../manifest.json/background/index.html | 2 +- .../manifest.json/browser_action/index.html | 2 +- .../browser_specific_settings/index.html | 4 +-- .../manifest.json/chrome_url_overrides/index.html | 2 +- .../manifest.json/description/index.html | 2 +- .../manifest.json/homepage_url/index.html | 2 +- .../add-ons/webextensions/manifest.json/index.html | 6 ++-- .../manifest.json/options_ui/index.html | 4 +-- .../manifest.json/permissions/index.html | 2 +- .../manifest.json/protocol_handlers/index.html | 2 +- .../manifest.json/sidebar_action/index.html | 6 ++-- .../webextensions/manifest.json/theme/index.html | 4 +-- .../webextensions/manifest.json/version/index.html | 4 +-- .../manifest.json/version_name/index.html | 2 +- .../web_accessible_resources/index.html | 2 +- .../webextensions/modify_a_web_page/index.html | 6 ++-- .../webextensions/native_manifests/index.html | 6 ++-- .../webextensions/native_messaging/index.html | 10 +++---- .../user_interface/browser_action/index.html | 8 ++--- .../user_interface/devtools_panels/index.html | 6 ++-- .../user_interface/extension_pages/index.html | 2 +- .../webextensions/user_interface/index.html | 26 ++++++++--------- .../user_interface/options_pages/index.html | 10 +++---- .../user_interface/page_actions/index.html | 10 +++---- .../webextensions/user_interface/popups/index.html | 12 ++++---- .../what_are_webextensions/index.html | 8 ++--- .../webextensions/working_with_files/index.html | 14 ++++----- .../your_first_webextension/index.html | 6 ++-- .../your_second_webextension/index.html | 34 +++++++++++----------- 96 files changed, 253 insertions(+), 253 deletions(-) (limited to 'files/ja/mozilla') diff --git a/files/ja/mozilla/add-ons/webextensions/add_a_button_to_the_toolbar/index.html b/files/ja/mozilla/add-ons/webextensions/add_a_button_to_the_toolbar/index.html index b70402a17d..93e076c698 100644 --- a/files/ja/mozilla/add-ons/webextensions/add_a_button_to_the_toolbar/index.html +++ b/files/ja/mozilla/add-ons/webextensions/add_a_button_to_the_toolbar/index.html @@ -85,7 +85,7 @@ browser.browserAction.onClicked.addListener(openPage); background.js manifest.json -

ここで拡張機能をインストールしてボタンをクリックします:

+

ここで拡張機能をインストールしてボタンをクリックします:

{{EmbedYouTube("kwwTowgT-Ys")}}

diff --git a/files/ja/mozilla/add-ons/webextensions/api/alarms/index.html b/files/ja/mozilla/add-ons/webextensions/api/alarms/index.html index 3f37d24473..a62c85b880 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/alarms/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/alarms/index.html @@ -5,7 +5,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/alarms ---
{{AddonSidebar}}
-

コードが動作するタイミングを予約します。この API は setTimeout()setInterval() と似ていますが、 alarms API はバックグラウンドで動作する点が異なります。

+

コードが動作するタイミングを予約します。この API は setTimeout()setInterval() と似ていますが、 alarms API はバックグラウンドで動作する点が異なります。

この API を利用するには "alarms" パーミッション が必要です。

diff --git a/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.html b/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.html index c1c073c551..af7b56a722 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.html @@ -14,9 +14,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks ---

{{AddonSidebar}}

-

WebExtensions {{WebExtAPIRef("bookmarks")}} API を利用すると、拡張機能からブラウザーのブックマークシステムにアクセスしたり、操作することができます。ページをブックマークしたり、既存のブックマークを取得したり、ブックマークを編集・削除・整理することが可能です。

+

WebExtensions {{WebExtAPIRef("bookmarks")}} API を利用すると、拡張機能からブラウザーのブックマークシステムにアクセスしたり、操作することができます。ページをブックマークしたり、既存のブックマークを取得したり、ブックマークを編集・削除・整理することが可能です。

-

この API を使用する際は、拡張機能の manifest.json ファイルで "bookmarks" パーミッション を指定する必要があります。

+

この API を使用する際は、拡張機能の manifest.json ファイルで "bookmarks" パーミッション を指定する必要があります。

拡張機能ではブックマークツリーのルートノードではブックマークを作成・編集・削除できません。それをしようとすると次のエラーになります: "The bookmark root cannot be modified"

diff --git a/files/ja/mozilla/add-ons/webextensions/api/bookmarks/search/index.html b/files/ja/mozilla/add-ons/webextensions/api/bookmarks/search/index.html index 4532e33fdd..673f7a3fa6 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/bookmarks/search/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/bookmarks/search/index.html @@ -17,7 +17,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/search

bookmarks.search() 関数は、指定したクエリにマッチするブックマークを検索するものです。マッチしたブックマークは、{{WebExtAPIRef('bookmarks.BookmarkTreeNode')}} オブジェクトの配列として、指定されたコールバック関数の引数に渡されます。

-

入力引数の値や型が不正だった場合、この関数は例外を送出します。エラーメッセージはコンソールで確認できます。送出された例外はエラー ID を含んでおらず、またメッセージを変更される可能性があるため、これらを解析するようなコードは書かないでください。

+

入力引数の値や型が不正だった場合、この関数は例外を送出します。エラーメッセージはコンソールで確認できます。送出された例外はエラー ID を含んでおらず、またメッセージを変更される可能性があるため、これらを解析するようなコードは書かないでください。

構文

diff --git a/files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html b/files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html index f5291179ee..1404bbba10 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html @@ -83,7 +83,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction

{{Compat("webextensions.api.browserAction")}}

diff --git a/files/ja/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.html b/files/ja/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.html index 9b632cf33c..5497f9aba2 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.html @@ -7,7 +7,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/onClicked

ブラウザアクションアイコンがクリックされたときに発火します。このイベントはブラウザアクションがポップアップを持っているときは発火しません。

-

右クリックを定義するには、contextMenus API の"browser_action" context typeを利用してください。

+

右クリックを定義するには、contextMenus API の"browser_action" context typeを利用してください。

書式

diff --git a/files/ja/mozilla/add-ons/webextensions/api/browsersettings/index.html b/files/ja/mozilla/add-ons/webextensions/api/browsersettings/index.html index a9bbf45a6a..de27090435 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/browsersettings/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/browsersettings/index.html @@ -22,7 +22,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings
 
-

この API を使うには "browserSettings" パーミッションが必要です。

+

この API を使うには "browserSettings" パーミッションが必要です。

プロパティ

diff --git a/files/ja/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.html b/files/ja/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.html index 28cd218da1..3e1e3237f8 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.html @@ -18,7 +18,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeCache

この関数は{{WebExtAPIRef("browsingData.RemovalOptions")}} オブジェクトを引数に取りますが無視されます。そのためこの関数を使うとすべてのキャッシュが消去されるため注意してください。

-

この関数は Promise を返す非同期関数です。

+

この関数は Promise を返す非同期関数です。

構文

@@ -36,7 +36,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeCache

返り値

-

消去が完了した後に実行される Promise が返されます。この Promise は引数を持ちません。エラーが発生した場合はエラーメッセージを引数にしてrejectを呼び出します。

+

消去が完了した後に実行される Promise が返されます。この Promise は引数を持ちません。エラーが発生した場合はエラーメッセージを引数にしてrejectを呼び出します。

ブラウザ実装状況

diff --git a/files/ja/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.html b/files/ja/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.html index d79122fdae..9925f45900 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.html @@ -7,7 +7,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard/setImageData

イメージをクリップボードにコピーします。イメージはクリップボードに書き込まれる前に再エンコードされます。イメージが無効な場合、クリップボードは修正されません。

-

The image is provided as an ArrayBuffer containing the encoded image. JPEG and PNG formats are supported.

+

The image is provided as an ArrayBuffer containing the encoded image. JPEG and PNG formats are supported.

Although this API is based on Chrome's clipboard.setImageData() API, there are some differences:

@@ -18,7 +18,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard/setImageData
  • This API does not support the additionalItems parameter.
  • -

    これはPromiseを返す非同期関数です。

    +

    これはPromiseを返す非同期関数です。

    書式

    @@ -29,14 +29,14 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard/setImageData
    imageData
    -
    An ArrayBuffer containing the encoded image data to copy to the clipboard.
    +
    An ArrayBuffer containing the encoded image data to copy to the clipboard.
    imageType
    A {{domxref("DOMString")}} indicating the type of image contained in imageData: "png" or "jpeg".

    返り値

    -

    A Promise that will be resolved with no arguments if the operation succeeded, or rejected if there was an error (for example, because the data did not represent a valid image).

    +

    A Promise that will be resolved with no arguments if the operation succeeded, or rejected if there was an error (for example, because the data did not represent a valid image).

    ブラウザ互換性

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/commands/index.html b/files/ja/mozilla/add-ons/webextensions/api/commands/index.html index 0e622b38d2..b1d10465d8 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/commands/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/commands/index.html @@ -12,13 +12,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/commands ---
    {{AddonSidebar}}
    -

    commands manifest.json キーを使って、登録したコマンドをユーザーが実行するのをリッスンします。

    +

    commands manifest.json キーを使って、登録したコマンドをユーザーが実行するのをリッスンします。

    {{WebExtAPIRef("commands.Command")}}
    -
    コマンドを表す型。これは manifest.json の commands キーのコマンドで指定された情報が入っています。
    +
    コマンドを表す型。これは manifest.json の commands キーのコマンドで指定された情報が入っています。

    関数

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/contentscripts/index.html b/files/ja/mozilla/add-ons/webextensions/api/contentscripts/index.html index d72cf1de1d..5726499a9b 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/contentscripts/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/contentscripts/index.html @@ -18,11 +18,11 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/contentScripts

    このAPIはmanifest.jsonにある"content_scripts"キーと似ていますが、"content_scripts"ではコンテントスクリプトとURLのパターンはインストールタイムに固定されます。一方content_scripts APIは、ランタイム(実行時)でスクリプトを登録・登録解除することが可能です。

    -

    このAPIは、{{WebExtAPIRef("contentScripts.register()")}} メソッドを呼び出して使用していただけます。その際は、登録するコンテントスクリプト、URLのマッチングパターン、またその他のオプションを実引数(arguments)として渡してください。このメソッドは{{WebExtAPIRef("contentScripts.RegisteredContentScript")}} オブジェクトがresolveされた Promise を返します。

    +

    このAPIは、{{WebExtAPIRef("contentScripts.register()")}} メソッドを呼び出して使用していただけます。その際は、登録するコンテントスクリプト、URLのマッチングパターン、またその他のオプションを実引数(arguments)として渡してください。このメソッドは{{WebExtAPIRef("contentScripts.RegisteredContentScript")}} オブジェクトがresolveされた Promise を返します。

    RegisteredContentScript オブジェクトは register() で登録されたスクリプトを保持し、unregister()でそのスクリプトを登録解除(unregister)できます。また、コンテントスクリプトはそれらを作ったページが消された際にも自動的に登録解除されます。例えば、backgroundページによって登録されたコンテントスクリプトは、backgroundページが消去された際に自動的に登録解除されます。

    -

    contentScripts API にパーミッションは存在しませんが、拡張機能はregister()でマッチさせるURLにおいては適切なhost permissionsを持っている必要があります。

    +

    contentScripts API にパーミッションは存在しませんが、拡張機能はregister()でマッチさせるURLにおいては適切なhost permissionsを持っている必要があります。

    Types

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/contentscripts/register/index.html b/files/ja/mozilla/add-ons/webextensions/api/contentscripts/register/index.html index 3f337606a8..e3613e2d4b 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/contentscripts/register/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/contentscripts/register/index.html @@ -16,7 +16,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/contentScripts/register

    manifest.json内の content_scripts に似た一つのオブジェクトを引数に持ちます。content_scripts では配列ですが、この register() ではオブジェクトを引数に持ちます。

    -

    これは Promise を返す非同期関数です。

    +

    これは Promise を返す非同期関数です。

    構文

    @@ -64,7 +64,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/contentScripts/register

    返り値

    -

    登録したコンテントスクリプトを削除することができる {{WebExtAPIRef("contentScripts.RegisteredContentScript")}} オブジェクトを引数に持つ Promise を返します。

    +

    登録したコンテントスクリプトを削除することができる {{WebExtAPIRef("contentScripts.RegisteredContentScript")}} オブジェクトを引数に持つ Promise を返します。


    現在、登録したコンテントスクリプトは、これを登録した拡張機能ページをアンロードしたときに削除されます。したがって、コンテントスクリプトを登録する際は、少なくとも登録されたままであってほしいだけ存在する拡張機能ページから登録すべきです。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/contextualidentities/index.html b/files/ja/mozilla/add-ons/webextensions/api/contextualidentities/index.html index 46f956e09e..3b74a702f6 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/contextualidentities/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/contextualidentities/index.html @@ -23,7 +23,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities

    Contextual identities は現在その他のブラウザーではサポートされていません。

    -

    この API を使うには、 manifest.json ファイル内で "contextualIdentities" パーミッションを入れます。

    +

    この API を使うには、 manifest.json ファイル内で "contextualIdentities" パーミッションを入れます。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/cookies/cookie/index.html b/files/ja/mozilla/add-ons/webextensions/api/cookies/cookie/index.html index 1282d09fa0..a6cf135e1b 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/cookies/cookie/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/cookies/cookie/index.html @@ -27,7 +27,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/Cookie
    expirationDate{{optional_inline}}
    cookie の有効期限をUNIX時刻からの秒数で持つ number 型です。セッション cookie はこのプロパティを持っていません。
    firstPartyDomain
    -
    cookie に関連付けられたファーストパーティドメインを表す文字列を格納している string 型です。 cookie のFirst-party isolationが無効の間は空文字列になります。詳細は First-party isolation をご覧ください。
    +
    cookie に関連付けられたファーストパーティドメインを表す文字列を格納している string 型です。 cookie のFirst-party isolationが無効の間は空文字列になります。詳細は First-party isolation をご覧ください。
    hostOnly
    boolean 型です。cookie がホストオンリークッキー (リクエストのホストが cookie の指定ドメインと完全一致している場合のみ送信) である場合に true 、でなければ false になります。
    httpOnly
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/cookies/index.html b/files/ja/mozilla/add-ons/webextensions/api/cookies/index.html index 63788a4292..644c3ef6b2 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/cookies/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/cookies/index.html @@ -15,7 +15,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/cookies

    拡張機能に cookie の取得と設定と、変更された時の通知を可能にします。

    -

    この API を使用するには、manifest.json ファイルで "cookies" の API パーミッション があることと、同様にアクセスする cookie を持つ host パーミッション も必要になります。cookie パーミッションを見てください。

    +

    この API を使用するには、manifest.json ファイルで "cookies" の API パーミッション があることと、同様にアクセスする cookie を持つ host パーミッション も必要になります。cookie パーミッションを見てください。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/eval/index.html b/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/eval/index.html index 7d32c2801c..83318bdd30 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/eval/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/eval/index.html @@ -64,7 +64,7 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow/eval

    Return value

    -

    A Promise that will be fulfilled with an array containing two elements.

    +

    A Promise that will be fulfilled with an array containing two elements.

    If no error occurred, element 0 will contain the result of evaluating the expression, and element 1 will be undefined.

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.html b/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.html index 39d50588a4..8a5b774701 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.html @@ -14,7 +14,7 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow
    {{AddonSidebar}}
    -

    このページは Firefox 54 に存在する WebExtensions devtools APIs を記述しています。このAPI は Chrome devtools APIs に基づいていますが、Firefoxでは実装されていない多くの機能があり、よってここに文書化されていません。現在欠けている機能を見るには、 Limitations of the devtools APIs を見てください。

    +

    このページは Firefox 54 に存在する WebExtensions devtools APIs を記述しています。このAPI は Chrome devtools APIs に基づいていますが、Firefoxでは実装されていない多くの機能があり、よってここに文書化されていません。現在欠けている機能を見るには、 Limitations of the devtools APIs を見てください。

    devtools.inspectedWindow API によって開発ツール拡張機能では開発ツールが割当てられたウィンドウと相互作用できます。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/devtools/network/index.html b/files/ja/mozilla/add-ons/webextensions/api/devtools/network/index.html index 7bc171b612..52d78a9627 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/devtools/network/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/devtools/network/index.html @@ -14,12 +14,12 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.network
    {{AddonSidebar}}
    -

    このページは Firefox 54 に存在する WebExtensions devtools APIs を記述しています。このAPI は Chrome devtools APIs に基づいていますが、Firefoxでは実装されていない多くの機能があり、よってここに文書化されていません。現在欠けている機能を見るには、 Limitations of the devtools APIs を見てください。

    +

    このページは Firefox 54 に存在する WebExtensions devtools APIs を記述しています。このAPI は Chrome devtools APIs に基づいていますが、Firefoxでは実装されていない多くの機能があり、よってここに文書化されていません。現在欠けている機能を見るには、 Limitations of the devtools APIs を見てください。

    devtools.network API によって開発ツール拡張機能では開発ツールが付属しているウィンドウ(インスペクト対象ウィンドウ)に関連するネットワークリクエストの情報を取得できます。

    -

    すべての devtools API と同様に、この API はmanifest.json devtools_page キー内に定義されたドキュメントや、拡張機能が作成するその他の開発ツールドキュメント(例えば拡張機能が作ったパネル自身のドキュメント)の中だけでコードを利用できます。これ以上は 開発ツールを拡張するを見てください。

    +

    すべての devtools API と同様に、この API はmanifest.json devtools_page キー内に定義されたドキュメントや、拡張機能が作成するその他の開発ツールドキュメント(例えば拡張機能が作ったパネル自身のドキュメント)の中だけでコードを利用できます。これ以上は 開発ツールを拡張するを見てください。

    Events

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/downloads/download/index.html b/files/ja/mozilla/add-ons/webextensions/api/downloads/download/index.html index 8616ce3585..b9f5bdb3e2 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/downloads/download/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/downloads/download/index.html @@ -12,7 +12,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/download
  • filename と saveAs が指定されている場合、指定されたfilenameが設定された[名前をつけて保存]のダイアログが開きます。
  • -

    この関数は非同期に実行され、Promiseを返します。

    +

    この関数は非同期に実行され、Promiseを返します。

    構文

    @@ -35,7 +35,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/download
    filename{{optional_inline}}
    A string representing a file path relative to the default downloads directory — this provides the location where you want the file to be saved, and what filename you want to use. Absolute paths, empty paths, and paths containing back-references (../) will cause an error. If omitted, this value will default to the filename already given to the download file, and a location immediately inside the downloads directory.
    headers{{optional_inline}}
    -
    An array of objects representing extra HTTP headers to send with the request if the URL uses the HTTP[s] protocol. Each header is represented as a dictionary object containing the keys name and either value or binaryValue, restricted to those allowed by XMLHttpRequest.
    +
    An array of objects representing extra HTTP headers to send with the request if the URL uses the HTTP[s] protocol. Each header is represented as a dictionary object containing the keys name and either value or binaryValue, restricted to those allowed by XMLHttpRequest.
    incognito{{optional_inline}}
    A boolean: if present and set to true, then associate this download with a private browsing session. This means that it will only appear in the download manager for any private windows that are currently open.
    method{{optional_inline}}
    @@ -54,7 +54,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/download

    戻り値

    -

    Promiseが返却されます。ダウンロードが成功した場合、new {{WebExtAPIRef("downloads.DownloadItem")}}のidが格納されたpromiseを受け取ります。対して、promiseがrejectされた場合は、エラーメッセージを受け取ります。

    +

    Promiseが返却されます。ダウンロードが成功した場合、new {{WebExtAPIRef("downloads.DownloadItem")}}のidが格納されたpromiseを受け取ります。対して、promiseがrejectされた場合は、エラーメッセージを受け取ります。

    ブラウザ実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/downloads/index.html b/files/ja/mozilla/add-ons/webextensions/api/downloads/index.html index 98dcaef054..13947d80e5 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/downloads/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/downloads/index.html @@ -16,7 +16,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads

    拡張機能にブラウザーのダウンロードマネージャーとのやりとりを可能にします。このAPI モジュールを、ファイルマネージャーでのファイルのダウンロード、キャンセル、停止、ダウンロードの再開、ダウンロード済みのファイルの表示に使用できます。

    -

    このAPIを使うには manifest.json ファイルで指定する "downloads" API パーミッションが必要です。

    +

    このAPIを使うには manifest.json ファイルで指定する "downloads" API パーミッションが必要です。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/extensiontypes/index.html b/files/ja/mozilla/add-ons/webextensions/api/extensiontypes/index.html index 3c6424f619..c4e2cac8ca 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/extensiontypes/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/extensiontypes/index.html @@ -26,7 +26,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes
    {{WebExtAPIRef("extensionTypes.RunAt")}}
    タブに JavaScript か CSS が挿入されてほんのすぐ
    extensionTypes.CSSOrigin
    -
    tabs.insertCSS で挿入された CSS スタイルシートが "author" か "user" のスタイルシートのどちらであるかを示す
    +
    tabs.insertCSS で挿入された CSS スタイルシートが "author" か "user" のスタイルシートのどちらであるかを示す

    ブラウザ実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/find/find/index.html b/files/ja/mozilla/add-ons/webextensions/api/find/find/index.html index 61f777789e..a062774466 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/find/find/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/find/find/index.html @@ -29,7 +29,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/find/find
  • {{WebExtAPIRef("find.highlightResults()")}},
  • -

    この関数は asynchronous/ 非同期 関数で Promise を返します。

    +

    この関数は asynchronous/ 非同期 関数で Promise を返します。

    Syntax

    @@ -65,7 +65,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/find/find

    Return value

    -

    A Promise that will be fulfilled with an object containing up to three properties:

    +

    A Promise that will be fulfilled with an object containing up to three properties:

    count
    @@ -141,7 +141,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/find/find browser.find.find("banana").then(found); -

    Search for "banana" across all tabs (note that this requires the "tabs" permission, because it accesses tab.url):

    +

    Search for "banana" across all tabs (note that this requires the "tabs" permission, because it accesses tab.url):

    async function findInAllTabs(allTabs) {
       for (let tab of allTabs) {
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/history/index.html b/files/ja/mozilla/add-ons/webextensions/api/history/index.html
    index d283cb7bcb..ae579d610b 100644
    --- a/files/ja/mozilla/add-ons/webextensions/api/history/index.html
    +++ b/files/ja/mozilla/add-ons/webextensions/api/history/index.html
    @@ -17,7 +17,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history
     

    ブラウザー履歴とやりとりする history API を使用します。

    -

    downloads は HistoryItem オブジェクトとして扱われるのに注意します。このため、ダウンロードのために history.onVisited も発火します。

    +

    downloads は HistoryItem オブジェクトとして扱われるのに注意します。このため、ダウンロードのために history.onVisited も発火します。

    ブラウザー履歴はユーザーが訪れたページの時間順の記録です。history API では次の事ができます:

    @@ -36,7 +36,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history
  • 所定の期間に訪問したあらゆるページの訪問を削除する
  • -

    このAPIを使うには manifest.json ファイルで指定する "history" パーミッションが必要です。

    +

    このAPIを使うには manifest.json ファイルで指定する "history" パーミッションが必要です。

    @@ -57,7 +57,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history
    {{WebExtAPIRef("history.search()")}}
    -
    ブラウザー履歴を検索して、所与の条件にマッチする history.HistoryItem オブジェクトを得る
    +
    ブラウザー履歴を検索して、所与の条件にマッチする history.HistoryItem オブジェクトを得る
    {{WebExtAPIRef("history.getVisits()")}}
    所定のページへの訪問についての情報を取得する
    {{WebExtAPIRef("history.addUrl()")}}
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html b/files/ja/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html index 8b28aeee9b..edbd807443 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html @@ -17,7 +17,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/detectLanguage

    提供されたテキストの言語を Compact Language Detector (CLD) を利用して検出します。

    -

    これは、Promise を返す非同期関数です。

    +

    これは、Promise を返す非同期関数です。

    構文

    @@ -35,7 +35,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/detectLanguage

    戻り値

    -

    結果オブジェクトで解決される Promise。結果オブジェクトは 2 個のプロパティを持ちます:

    +

    結果オブジェクトで解決される Promise。結果オブジェクトは 2 個のプロパティを持ちます:

    isReliable
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.html b/files/ja/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.html index 8d639e241b..83a6cabb70 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.html @@ -16,7 +16,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/identity/getRedirectURL

    リダイレクト URL として利用可能な URL を生成します。

    -

    この URL は、アドオン ID から生成されるため、使用したい場合、browser_specific_settings キーを使用してアドオン ID を明示的に設定する必要があるでしょう (設定しない場合、アドオンを一時的にインストールするたびに、異なるリダイレクト URL を取得することになります)。

    +

    この URL は、アドオン ID から生成されるため、使用したい場合、browser_specific_settings キーを使用してアドオン ID を明示的に設定する必要があるでしょう (設定しない場合、アドオンを一時的にインストールするたびに、異なるリダイレクト URL を取得することになります)。

    リダイレクトURL については、リダイレクトURL を取得するを参照してください。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/identity/index.html b/files/ja/mozilla/add-ons/webextensions/api/identity/index.html index 29d946d813..90200ebbc2 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/identity/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/identity/index.html @@ -25,7 +25,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/identity

    そして、OAuth2 フローを実施して取得した検証済みアクセストークンを、HTTP リクエスト内で使用することで、拡張機能はユーザーから認可された範囲でデータにアクセスできるようになります。

    -

    この API を利用するためには、"identity" API のパーミッションが必要です。

    +

    この API を利用するためには、"identity" API のパーミッションが必要です。

    セットアップ

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/idle/index.html b/files/ja/mozilla/add-ons/webextensions/api/idle/index.html index e92112e732..7978e10527 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/idle/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/idle/index.html @@ -16,7 +16,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/idle

    ユーザーのシステムがアイドル状態、ロックされた状態、アクティブな状態であるのを発見します。

    -

    この API を使うには "idle" パーミッションが必要です。

    +

    この API を使うには "idle" パーミッションが必要です。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/index.html b/files/ja/mozilla/add-ons/webextensions/api/index.html index e7ffc434a7..b813ae50d9 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/index.html @@ -8,9 +8,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API
    {{AddonSidebar}}
    -

    WebExtension 用の JavaScript API は拡張機能のバックグラウンドスクリプトと、その他の拡張機能にバンドルした文書 (ブラウザーアクションページアクションポップアップやサイドバーオプションページ新規タブページを含む) で使用できます。いくつかの API は拡張機能のコンテンツスクリプトからもアクセスできます (コンテンツスクリプトガイドの表を見てください)。

    +

    WebExtension 用の JavaScript API は拡張機能のバックグラウンドスクリプトと、その他の拡張機能にバンドルした文書 (ブラウザーアクションページアクションポップアップやサイドバーオプションページ新規タブページを含む) で使用できます。いくつかの API は拡張機能のコンテンツスクリプトからもアクセスできます (コンテンツスクリプトガイドの表を見てください)。

    -

    もっと強力な API を使うには、拡張機能の manifest.jsonパーミッションをリクエストする必要があります。

    +

    もっと強力な API を使うには、拡張機能の manifest.jsonパーミッションをリクエストする必要があります。

    browser 名前空間内で API にアクセスできます:

    @@ -33,7 +33,7 @@ browser.tabs} let setCookie = browser.cookies.set( - {url: "https://developer.mozilla.org/"} + {url: "/"} ); setCookie.then(logCookie, logError);
    @@ -45,7 +45,7 @@ setCookie.th

    Microsoft Edge は browser 名前空間を使いますが、promise ベースの非同期 API はサポートされていません。Edge では当面、非同期 API はコールバックを使うのが必須です。

    -

    すべてのブラウザーがすべての API をサポートしているわけではありません: 詳しくは  JavaScript API のブラウザーサポートをご覧ください。

    +

    すべてのブラウザーがすべての API をサポートしているわけではありません: 詳しくは  JavaScript API のブラウザーサポートをご覧ください。

    JavaScript API 一覧

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/management/index.html b/files/ja/mozilla/add-ons/webextensions/api/management/index.html index 06042d1093..694c72d2c8 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/management/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/management/index.html @@ -24,7 +24,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/management
  • アドオンのインストール・有効・無効の状態に関する通知の取得
  • -

    操作のほとんどは "management" API パーミッションを要求します。他のアドオンへのアクセスを提供しない操作はこのパーミッションを要求しません。

    +

    操作のほとんどは "management" API パーミッションを要求します。他のアドオンへのアクセスを提供しない操作はこのパーミッションを要求しません。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/menus/index.html b/files/ja/mozilla/add-ons/webextensions/api/menus/index.html index 5cb7281ea6..49eafb4bfe 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/menus/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/menus/index.html @@ -21,9 +21,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus

    Firefox 55 より前ではこの API は contextMenus という名前でした。その名称は一応エイリアスにしています。そのため contextMenus という名称を使ってFirefoxや他のブラウザでも動くコードを書くことできます。

    -

    このAPIを使用するためには menus  permission 必要です。 menus の代わりにエイリアスの contextMenus を使用することができますが、もし使用するのであればbrowser.contextMenus でAPIにアクセスしなければなりません。.

    +

    このAPIを使用するためには menus  permission 必要です。 menus の代わりにエイリアスの contextMenus を使用することができますが、もし使用するのであればbrowser.contextMenus でAPIにアクセスしなければなりません。.

    -

    この API はmenus.getTargetElement()以外はコンテンツスクリプトからは使用できません。バックグラウンドページからは使えます。

    +

    この API はmenus.getTargetElement()以外はコンテンツスクリプトからは使用できません。バックグラウンドページからは使えます。

    メニューアイテムをつくる

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/notifications/create/index.html b/files/ja/mozilla/add-ons/webextensions/api/notifications/create/index.html index 9230ce54bf..6285222c2b 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/notifications/create/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/notifications/create/index.html @@ -11,7 +11,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/create

    You can optionally provide an ID for the notification. If you omit the ID, an ID will be generated. You can use the ID to {{WebExtAPIRef("notifications.update()", "update")}} or {{WebExtAPIRef("notifications.clear()", "clear")}} the notification.

    -

    This is an asynchronous function that returns a Promise.

    +

    This is an asynchronous function that returns a Promise.

    If you call notifications.create() more than once in rapid succession, Firefox may end up not displaying any notification at all.

    @@ -36,7 +36,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/create

    返り値

    -

    A Promise that will be fulfilled when the notification is created and the display process has been started, which is before the notification is actually displayed to the user. It is fulfilled with a string representing the notification's ID.

    +

    A Promise that will be fulfilled when the notification is created and the display process has been started, which is before the notification is actually displayed to the user. It is fulfilled with a string representing the notification's ID.

    ブラウザ互換性

    @@ -46,7 +46,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/create

    Create and display a basic notification periodically, using an {{WebExtAPIRef("alarms", "alarm")}}. Clicking the browser action dismisses the notification.

    -

    Note that you'll need the "alarms" permission to create alarms (as well as the "notifications" permission to create notifications).

    +

    Note that you'll need the "alarms" permission to create alarms (as well as the "notifications" permission to create notifications).

    var cakeNotification = "cake-notification"
     
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/pageaction/index.html b/files/ja/mozilla/add-ons/webextensions/api/pageaction/index.html
    index 9aa608ef46..a6b46c9d88 100644
    --- a/files/ja/mozilla/add-ons/webextensions/api/pageaction/index.html
    +++ b/files/ja/mozilla/add-ons/webextensions/api/pageaction/index.html
    @@ -18,7 +18,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction
     
     

    -

    You can listen for clicks on the icon, or specify a popup that will open when the icon is clicked.

    +

    You can listen for clicks on the icon, or specify a popup that will open when the icon is clicked.

    If you specify a popup, you can define its contents and behavior using HTML, CSS, and JavaScript, just like a normal web page. JavaScript running in the popup gets access to all the same WebExtension APIs as your background scripts.

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/permissions/index.html b/files/ja/mozilla/add-ons/webextensions/api/permissions/index.html index 34e1e36ae1..468a561d0f 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/permissions/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/permissions/index.html @@ -75,7 +75,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/permissions

    その他

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/proxy/index.html b/files/ja/mozilla/add-ons/webextensions/api/proxy/index.html index 8b76402361..e85eb9c6fb 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/proxy/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/proxy/index.html @@ -14,7 +14,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/proxy

    Google Chrome では 同じく"proxy"という拡張機能API が提供されていて、その機能はこの API と似ていて、拡張機能はプロキシポリシーを使うことができます。しかし、Chrome API の設計はこの API とまったく違います。Chrome の API では拡張機能は PAC ファイルを定義できて、明示的なプロキシルールも定義できます。このため拡張機能 PAC ファイルも使用できて、この API は PAC ファイルアプローチのみをサポートします。この API は Chrome proxy API と互換性がないため、この API は browser 名前空間のみで利用できます。

    -

    この API を使うには、"proxy" パーミッションが必要です。

    +

    この API を使うには、"proxy" パーミッションが必要です。

    PAC ファイルと通信する

    @@ -53,7 +53,7 @@ browser.runtime.onMessage.addListener((message) => {

    FindProxyForURL() return value

    -

    The standard FindProxyForURL() returns a string. In Firefox 55 and 56, the PAC file used with the proxy API also returns a string. In Firefox 55 only, you must pass an argument to the "DIRECT" return value, even though it doesn't need an argument.

    +

    The standard FindProxyForURL() returns a string. In Firefox 55 and 56, the PAC file used with the proxy API also returns a string. In Firefox 55 only, you must pass an argument to the "DIRECT" return value, even though it doesn't need an argument.

    From Firefox 57 onwards, FindProxyForURL() may still return a string, but may alternatively (and preferably) return an array of objects. Each object has the following properties:

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html b/files/ja/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html index 86eb8d325d..9bfc19370f 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html @@ -39,13 +39,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessage
  • sendResponse 関数。送信側への返信を送るために使います。
  • -

    メッセージに対して同期的に返信するには、sendResponse 関数をリスナーの中で実行します。例を参照してください

    +

    メッセージに対して同期的に返信するには、sendResponse 関数をリスナーの中で実行します。例を参照してください

    非同期的に返信するには、二つの方法があります。

      -
    • イベントリスナーから true を返す。こうすることで、リスナーから復帰した後でも sendResponse 関数が有効なままになるため、後で実行することができます。例を参照してください
    • -
    • イベントリスナーから Promise を返して、返信が準備できた後にそれを解決する (またはエラーの場合は拒否する)。例を参照してください
    • +
    • イベントリスナーから true を返す。こうすることで、リスナーから復帰した後でも sendResponse 関数が有効なままになるため、後で実行することができます。例を参照してください
    • +
    • イベントリスナーから Promise を返して、返信が準備できた後にそれを解決する (またはエラーの場合は拒否する)。例を参照してください
    @@ -153,7 +153,7 @@ window.addEv }
    -

    バックグラウンドスクリプトはこのメッセージが送信されるまで待ち、notifications API を使って通知を表示します。

    +

    バックグラウンドスクリプトはこのメッセージが送信されるまで待ち、notifications API を使って通知を表示します。

    // background-script.js
     
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.html b/files/ja/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.html
    index 44965c6f89..a1bab31eb9 100644
    --- a/files/ja/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.html
    +++ b/files/ja/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.html
    @@ -19,7 +19,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage
     
     
     
    -

    これは Promise を返す非同期関数です。

    +

    これは Promise を返す非同期関数です。

    構文

    @@ -32,7 +32,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage

    返り値

    -

    オプションページの作成が成功した時は、引数のない Promise で、操作が失敗した場合はエラーメッセージつきの rejected が返ります。

    +

    オプションページの作成が成功した時は、引数のない Promise で、操作が失敗した場合はエラーメッセージつきの rejected が返ります。

    ブラウザー実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.html b/files/ja/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.html index a358ef3c63..b7e2e90b17 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.html @@ -26,7 +26,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage
    -

    これは、Promise を返す非同期関数です。

    +

    これは、Promise を返す非同期関数です。

    コネクションベースのメッセージを使うこともできます。

    @@ -45,7 +45,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage
    extensionId{{optional_inline}}
    -
    string 型。 メッセージを送信する拡張機能の ID。別の拡張機能にメッセージを送信する場合は、この引数を含めてください。受信させることを意図している拡張機能が manifest.json の applications キーを使って明示的に ID を設定されている場合は、その値を extensionId に指定する必要があります。そうでない場合、受信側の拡張機能のために生成された ID を指定する必要があります。
    +
    string 型。 メッセージを送信する拡張機能の ID。別の拡張機能にメッセージを送信する場合は、この引数を含めてください。受信させることを意図している拡張機能が manifest.json の applications キーを使って明示的に ID を設定されている場合は、その値を extensionId に指定する必要があります。そうでない場合、受信側の拡張機能のために生成された ID を指定する必要があります。
    もし extensionId が省略された場合、メッセージは自分自身の拡張機能に送信されます。
    message
    any 型。シリアライズされたクローンに構造化できるオブジェクト。
    @@ -83,7 +83,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage

    戻り値

    -

    Promise 型。受信側が応答を送信する場合、その応答を JSON オブジェクトとして使って fulfilled 状態にされます。それ以外の場合、値を持たない fulfilled 状態になります。拡張機能との接続中にエラーが発生した場合、Promise はエラーメッセージを持つ rejected 状態になります。

    +

    Promise 型。受信側が応答を送信する場合、その応答を JSON オブジェクトとして使って fulfilled 状態にされます。それ以外の場合、値を持たない fulfilled 状態になります。拡張機能との接続中にエラーが発生した場合、Promise はエラーメッセージを持つ rejected 状態になります。

    ブラウザー実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/sessions/index.html b/files/ja/mozilla/add-ons/webextensions/api/sessions/index.html index 870cf96426..8847f8d505 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/sessions/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/sessions/index.html @@ -21,7 +21,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sessions

    この API は拡張機能にタブやウィンドウに関連する追加状態の保存させる関数グループも提供します。それで、タブやウィンドウが閉じられて順次復帰された場合、拡張機能は状態を取得できます。例えば、タブをグループ化する拡張機能は、これを使ってタブがどのグループにいるのかを記憶し、ユーザーがタブを復帰した時に正しいグループに復帰できるようになります。

    -

    セッション API を使うには "sessions" API パーミッションが必要です。

    +

    セッション API を使うには "sessions" API パーミッションが必要です。

    @@ -38,7 +38,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sessions
    {{WebExtAPIRef("sessions.MAX_SESSION_RESULTS")}}
    -
    sessions.getRecentlyClosed()の呼び出しで返される最大のセッション数。
    +
    sessions.getRecentlyClosed()の呼び出しで返される最大のセッション数。

    関数

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/index.html index 6286012f61..efad165c20 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/index.html @@ -25,7 +25,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage
  • 複数のキー/値ペアーが同じ API 呼び出しで設定、取得できます。
  • -

    この API を利用するためには"storage" permissionmanifest.json に含める必要があります。

    +

    この API を利用するためには"storage" permissionmanifest.json に含める必要があります。

    各々の拡張機能は独自のストレージ領域を持っています。またそれらは異なる型のストレージに分割することができます。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html index e69759effd..9a6b4e5296 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html @@ -10,7 +10,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/local

    ブラウザーは拡張機能がローカルストレージエリアに保存できるデータ量を制限します。

      -
    • Chromeでは、このAPIを使用して、"unlimitedStorage"パーミッションを許可しない場合は5MBまで保存できます。
    • +
    • Chromeでは、このAPIを使用して、"unlimitedStorage"パーミッションを許可しない場合は5MBまで保存できます。
    • Firefox ではバージョン56以降で"unlimitedStorage"パーミッションを利用できます。保存できるデータ量は現在では制限していませんが、将来的には制限するため、もし大きなデータ量を保存するのであれば"unlimitedStorage"パーミッションを今から使用するとよいでしょう。
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html index b8dc2aec62..02c2c3f04c 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html @@ -18,7 +18,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear

    全てのアイテムをストレージ領域から削除します。

    -

    この関数は Promise を返す非同期関数です。

    +

    この関数は Promise を返す非同期関数です。

    構文

    @@ -33,7 +33,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear

    返り値

    -

    成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    +

    成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    ブラウザ互換性

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html index d5ea70153c..c2f145525e 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html @@ -18,7 +18,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get

    ストレージ領域から1つ以上のアイテムを取得します。

    -

    この関数は Promise を返す非同期関数です。

    +

    この関数は Promise を返す非同期関数です。

    構文

    @@ -27,7 +27,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get )
    -

    <storageType>storage.sync または storage.local の書き込み可能なストレージタイプです。

    +

    <storageType>storage.sync または storage.local の書き込み可能なストレージタイプです。

    引数

    @@ -38,7 +38,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get

    返り値

    -

    成功時は keys で指定されたストレージ領域内のアイテム全てを含む results オブジェクトを引数に持つ Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    +

    成功時は keys で指定されたストレージ領域内のアイテム全てを含む results オブジェクトを引数に持つ Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    52 より前の Firefox バージョンのコンテンツスクリプトで使用する場合、 browser.storage.local.get() で返される Promise は1つのオブジェクトを持つ配列を引数に持ちます。配列内のオブジェクトは上記に記述したようにストレージ領域内の keys を持っています。 The Promise is correctly fulfilled with an Object when used in the background context (background scripts, popups, options pages, etc.). When this API is used as chrome.storage.local.get(), it correctly passes an Object to the callback function.

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html index ae2de4bb9e..e413f19381 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html @@ -17,7 +17,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesIn

    1つ以上のストレージ領域内に格納されたアイテムが占めるストレージ空間をバイト単位で取得します。

    -

    この関数は Promise を返す非同期関数です。

    +

    この関数は Promise を返す非同期関数です。

    構文

    @@ -37,7 +37,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesIn

    返り値

    -

    成功時は keys で指定されたオブジェクトが占めるストレージ空間を持つ整数 bytesUsed を引数に持つ Promise を返します。失敗した場合 Promise はエラーメッセージと共にリジェクトされます。

    +

    成功時は keys で指定されたオブジェクトが占めるストレージ空間を持つ整数 bytesUsed を引数に持つ Promise を返します。失敗した場合 Promise はエラーメッセージと共にリジェクトされます。

    ブラウザ実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html index daba7224fb..2afc7c02c3 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html @@ -38,7 +38,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/remove

    返り値

    -

    成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    +

    成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    ブラウザ実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html index 6860bc9c19..609fee944a 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html @@ -20,7 +20,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set

    この API を使用して保存や上書きをする場合、{{WebExtAPIRef("storage.onChanged")}} イベントが発火します。

    -

    この関数は Promise を返す非同期関数です。

    +

    この関数は Promise を返す非同期関数です。

    構文

    @@ -29,7 +29,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set ) -

    <storageType>storage.sync または storage.local の書き込み可能なストレージタイプです。

    +

    <storageType>storage.sync または storage.local の書き込み可能なストレージタイプです。

    Parameters

    @@ -46,7 +46,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set

    返り値

    -

    成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    +

    成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

    ブラウザ実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html index 132df88fae..11e5d90578 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html @@ -19,7 +19,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/sync

    Firefox の場合、ユーザーは "about:preferences" の "Sync 設定" オプションの下にある "アドオン" ボックスにチェックを入れる必要があります。

    -

    storage.sync の実装はアドオン ID に依存していることに注意してください。もし storage.sync を使うのであれば、 browser_specific_settings manifest.json キーを使用して拡張機能に ID を設定する必要があります。

    +

    storage.sync の実装はアドオン ID に依存していることに注意してください。もし storage.sync を使うのであれば、 browser_specific_settings manifest.json キーを使用して拡張機能に ID を設定する必要があります。

    この API の主な利用例は拡張機能の設定を格納し、異なるプロファイル間で同期させることです。この API は最大100 KB までデータを格納できます。それ以上格納しようとするとエラーメッセージを返して失敗します。 この API は稼働時間やパフォーマンスを保証しません。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html index 65a036c403..2e527139da 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html @@ -17,7 +17,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab

    指定ウィンドウの選択タブの表示領域の画像をエンコードしたデータ URI を作成します。このメソッドを使うには <all_urls> パーミッション が必要です (Chrome の場合、activeTab パーミッション があり、ユーザーが許可の操作を行えば、このメソッドを使うことができます)。

    -

    これは、Promise を返す非同期関数です。

    +

    これは、Promise を返す非同期関数です。

    構文

    @@ -38,7 +38,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab

    戻り値

    -

    Promise であり、キャプチャーされたタブの表示領域の画像をエンコードしたデータ URL で fulfilled 状態にされる。このデータ URL は、HTML イメージ要素の 'src' 属性に設定することで、画像を表示できる。もし何らかのエラーが発生した場合、Promise はエラーメッセージによって rejected 状態にされる。

    +

    Promise であり、キャプチャーされたタブの表示領域の画像をエンコードしたデータ URL で fulfilled 状態にされる。このデータ URL は、HTML イメージ要素の 'src' 属性に設定することで、画像を表示できる。もし何らかのエラーが発生した場合、Promise はエラーメッセージによって rejected 状態にされる。

    使用例

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/create/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/create/index.html index b3142538db..cf41c2b6dd 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/create/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/create/index.html @@ -7,7 +7,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/create

    新しいタブを作ります。

    -

    これはPromiseを返す非同期関数です.

    +

    これはPromiseを返す非同期関数です.

    構文

    @@ -26,13 +26,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/create
    active{{optional_inline}}
    タブをアクティブにするかどうかを真理値で指定します。ウィンドウがフォーカスされているかには影響されません({{WebExtAPIRef('windows.update')}}も参照)。デフォルト値はtrue.
    cookieStoreId {{optional_inline}}
    -
    文字列 。タブのcookie store IDがcookieStoreIdのタブを作るときに使用します。このオプションは拡張機能が"cookies" permissionを持つときのみ使用できます。
    +
    文字列 。タブのcookie store IDがcookieStoreIdのタブを作るときに使用します。このオプションは拡張機能が"cookies" permissionを持つときのみ使用できます。
    index{{optional_inline}}
    整数値。ウィンドウ中のタブの位置を指定します。数値はゼロからウィンドウ内のタブの数までです。
    openerTabId{{optional_inline}}
    整数値。開くタブのIDを指定します。指定した場合、開く側のタブは新しいタブと同じウィンドウにある必要があります。
    openInReaderMode{{optional_inline}}
    -
    真理値。もしtrueであればリーダーモードで開かれます。 デフォルトはfalse
    +
    真理値。もしtrueであればリーダーモードで開かれます。 デフォルトはfalse
    pinned{{optional_inline}}
    真理値。タブをピン留めするかを指定します。デフォルトはfalse
    selected{{optional_inline}}
    @@ -63,7 +63,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/create

    返り値

    -

    新しく作ったタブに関する{{WebExtAPIRef('tabs.Tab')}}オブジェクトを引数に持つPromiseが返されます。URLが特権URLであるなどして、タブが作られなかった場合はpromiseはエラーメッセージとともにrejectされます。

    +

    新しく作ったタブに関する{{WebExtAPIRef('tabs.Tab')}}オブジェクトを引数に持つPromiseが返されます。URLが特権URLであるなどして、タブが作られなかった場合はpromiseはエラーメッセージとともにrejectされます。

    ブラウザー互換状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html index c48c12ae03..a4ef65c343 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html @@ -7,7 +7,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate

    ID で指定されたタブを複製します。

    -

    この関数は Promise を返す非同期関数です。

    +

    この関数は Promise を返す非同期関数です。

    構文

    @@ -25,7 +25,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate

    戻り値

    -

    A Promise that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing details about the duplicated tab. The Tab object only contains url, title and favIconUrl if the extension has the "tabs" permission. If any error occurs the promise will be rejected with an error message.

    +

    A Promise that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing details about the duplicated tab. The Tab object only contains url, title and favIconUrl if the extension has the "tabs" permission. If any error occurs the promise will be rejected with an error message.

    ブラウザ実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/executescript/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/executescript/index.html index 82e1ee1686..124d7235a2 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/executescript/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/executescript/index.html @@ -17,7 +17,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript

    JavaScript のコードをページに挿入します。

    -

    コードを挿入できるページの URL は、マッチパターン により指定できます。 つまり、URL の scheme 部は、"http", "https", "file", "ftp" のいずれかでなければなりません。そして、その URL に対する明示的な host パーミッション、または activeTab パーミッションが必要です。

    +

    コードを挿入できるページの URL は、マッチパターン により指定できます。 つまり、URL の scheme 部は、"http", "https", "file", "ftp" のいずれかでなければなりません。そして、その URL に対する明示的な host パーミッション、または activeTab パーミッションが必要です。

    また、自らの拡張機能パッケージに含まれるページに対してであれば、次の方法でコードを挿入することも可能です。

    @@ -33,7 +33,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript

    挿入するスクリプトのことを、コンテンツスクリプトと呼びます。詳細は コンテンツスクリプト で学んでください。

    -

    これは、Promise を返す非同期関数です。

    +

    これは、Promise を返す非同期関数です。

    構文

    @@ -70,13 +70,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript

    戻り値

    -

    オブジェクト配列を使って fulfilled 状態にされる Promise です。それぞれのオブジェクトは、フレームに挿入されたスクリプトの結果を表します。

    +

    オブジェクト配列を使って fulfilled 状態にされる Promise です。それぞれのオブジェクトは、フレームに挿入されたスクリプトの結果を表します。

    スクリプトの結果とは最後に評価された文のことです。これは、Webコンソールで実行されたスクリプトの出力 (結果であって、console.log() の出力のことではありません) に似ています。例えば、次のようなスクリプトを挿入したとします。

    var foo='my result';foo;
    -

    この場合、結果配列には、文字列 "my result" が含まれます。結果は、structured clone が可能でなければなりません。最後の文を Promise にすることもできますが、webextension-polyfill ライブラリではサポートされていません。

    +

    この場合、結果配列には、文字列 "my result" が含まれます。結果は、structured clone が可能でなければなりません。最後の文を Promise にすることもできますが、webextension-polyfill ライブラリではサポートされていません。

    エラーが発生した場合、Promise はエラーメッセージを使って rejected 状態にされます。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/get/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/get/index.html index 767b11173d..06df254c61 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/get/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/get/index.html @@ -7,7 +7,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/get

    タブのIDを指定し、{{WebExtAPIRef("tabs.Tab")}}オブジェクトとしてタブの詳細を取得します。

    -

    これはPromiseを返す非同期関数です。

    +

    これはPromiseを返す非同期関数です。

    Syntax

    @@ -25,7 +25,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/get

    Return value

    -

    A Promise that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing information about the tab. If the tab could not be found or some other error occurs, the promise will be rejected with an error message.

    +

    A Promise that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing information about the tab. If the tab could not be found or some other error occurs, the promise will be rejected with an error message.

    Examples

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/index.html index 40f6ced315..692fccb284 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/index.html @@ -22,7 +22,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs

    この API の大半の使用に特別なパーミッションは要りませんが:

      -
    • Tab.url Tab.title Tab.favIconUrl, のアクセスには "tabs" パーミッションが必要です。また Firefox では URL による{{WebExtAPIRef("tabs.query", "問い合わせ")}}をするのにも "tabs" が必要です。
    • +
    • Tab.url Tab.title Tab.favIconUrl, のアクセスには "tabs" パーミッションが必要です。また Firefox では URL による{{WebExtAPIRef("tabs.query", "問い合わせ")}}をするのにも "tabs" が必要です。
    • {{WebExtAPIRef("tabs.executeScript()")}} や {{WebExtAPIRef("tabs.insertCSS()")}} を使うには、そのタブの host パーミッションが必要です。
    @@ -39,7 +39,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs
    タブがミュートされているかを示す真理値と、最後の変更の理由からなるオブジェクト。
    {{WebExtAPIRef("tabs.PageSettings")}}
    -

    tabs.saveAsPDF()メソッドにおいて、どのように PDF を描画するかを制御する。

    +

    tabs.saveAsPDF()メソッドにおいて、どのように PDF を描画するかを制御する。

    {{WebExtAPIRef("tabs.Tab")}}
    タブについての情報を含む。
    @@ -70,7 +70,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs
    {{WebExtAPIRef("tabs.captureVisibleTab()")}}
    特定のウィンドウのアクティブなタブの可視エリアの画像をエンコードしたデータURI を作成します。
    {{WebExtAPIRef("tabs.connect()")}}
    -
    あるタブにおいて、バックグラウンドスクリプト(またはその他ポップアップやオプションページのスクリプトなど特権スクリプト)と content scripts 間でのメッセージのやり取り用の経路を確保します。
    +
    あるタブにおいて、バックグラウンドスクリプト(またはその他ポップアップやオプションページのスクリプトなど特権スクリプト)と content scripts 間でのメッセージのやり取り用の経路を確保します。
    {{WebExtAPIRef("tabs.create()")}}
    新しいタブを作る。
    {{WebExtAPIRef("tabs.detectLanguage()")}}
    @@ -86,7 +86,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs
    {{WebExtAPIRef("tabs.getAllInWindow()")}} {{deprecated_inline}}
    特定のウィンドウ内のすべてのタブについての情報を取り出す。
    {{WebExtAPIRef("tabs.getCurrent()")}}
    -
    スクリプトが実行されているタブについての情報を tabs.Tab オブジェクトとして取り出す。
    +
    スクリプトが実行されているタブについての情報を tabs.Tab オブジェクトとして取り出す。
    {{WebExtAPIRef("tabs.getSelected()")}} {{deprecated_inline}}
    あるウィンドウにおいてタブが選択されているかを得る。
    {{WebExtAPIRef("tabs.getZoom()")}}
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/remove/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/remove/index.html index d7ee4d96b9..fdd18cf97a 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/remove/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/remove/index.html @@ -7,7 +7,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/remove

    1つ以上のタブを閉じます。

    -

    この関数は Promise を返す非同期関数です。

    +

    この関数は Promise を返す非同期関数です。

    構文

    @@ -25,7 +25,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/remove

    戻り値

    -

    A Promise that will be fulfilled with no arguments when all the specified tabs have been removed or their beforeunload prompts have been handled. If any error occurs, the promise will be rejected with an error message.

    +

    A Promise that will be fulfilled with no arguments when all the specified tabs have been removed or their beforeunload prompts have been handled. If any error occurs, the promise will be rejected with an error message.

    ブラウザ実装状況

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/tabs/tab/index.html b/files/ja/mozilla/add-ons/webextensions/api/tabs/tab/index.html index 31ee57d609..3e291f4cb6 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/tabs/tab/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/tabs/tab/index.html @@ -25,11 +25,11 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab
    autoDiscardable {{optional_inline}}
    boolean. Whether the tab can be discarded automatically by the browser when resources are low.
    cookieStoreId {{optional_inline}}
    -
    string. タブのクッキーストア。If different tabs can have different cookie stores (for example, to support contextual identity), you can pass this as the storeId option into various methods of the {{WebExtAPIRef("cookies")}} API, to set and get cookies associated with this tab's cookie store. Only present if the extension has the "cookies" permission.
    +
    string. タブのクッキーストア。If different tabs can have different cookie stores (for example, to support contextual identity), you can pass this as the storeId option into various methods of the {{WebExtAPIRef("cookies")}} API, to set and get cookies associated with this tab's cookie store. Only present if the extension has the "cookies" permission.
    discarded {{optional_inline}}
    boolean. タブが破棄されたか。 A discarded tab is one whose content has been unloaded from memory, but is still visible in the tab strip. Its content gets reloaded the next time it's activated.
    favIconUrl {{optional_inline}}
    -
    string. タブのfaviconのURL。Only present if the extension has the "tabs" permission. It may also be an empty string if the tab is loading.
    +
    string. タブのfaviconのURL。Only present if the extension has the "tabs" permission. It may also be an empty string if the tab is loading.
    height {{optional_inline}}
    integer. タブの高さのピクセル値。
    hidden
    @@ -47,9 +47,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab
    index
    integer. 0を底としたウィンドウの中のタブのインデックス。
    isArticle
    -
    boolean. Trueならrendered in Reader Modeで閲覧可能、falseならそれ以外。
    +
    boolean. Trueならrendered in Reader Modeで閲覧可能、falseならそれ以外。
    isInReaderMode
    -
    boolean. Trueならrendered in Reader Modeで閲覧中、falseならそれ以外。
    +
    boolean. Trueならrendered in Reader Modeで閲覧中、falseならそれ以外。
    lastAccessed
    double. タブが最後にアクセスされた時刻(単位: milliseconds since the epoch)。
    mutedInfo {{optional_inline}}
    @@ -67,9 +67,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab
    successorId {{optional_inline}}
    integer タブの後継者のID。
    title {{optional_inline}}
    -
    string. タブのタイトル。Only present if the extension has the "tabs" permission.
    +
    string. タブのタイトル。Only present if the extension has the "tabs" permission.
    url {{optional_inline}}
    -
    string. タブが表示しているドキュメントのURL。Only present if the extension has the "tabs" permission.
    +
    string. タブが表示しているドキュメントのURL。Only present if the extension has the "tabs" permission.
    width {{optional_inline}}
    integer. タブの横幅のピクセル値。
    windowId
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/topsites/index.html b/files/ja/mozilla/add-ons/webextensions/api/topsites/index.html index 5ee5e4386f..8bcb06823c 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/topsites/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/topsites/index.html @@ -18,7 +18,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/topSites

    ブラウザーはユーザーがこれらの場所に簡単に戻れるようにこれを維持します。Firefoxでは既定で「新しいタブ」ページには最もよく訪れるページのリストが提供されます。

    -

    topSites API を使うには "topSites" の API パーミッション必要です。

    +

    topSites API を使うには "topSites" の API パーミッション必要です。

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/webnavigation/index.html b/files/ja/mozilla/add-ons/webextensions/api/webnavigation/index.html index 4edae83299..55b9900953 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/webnavigation/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/webnavigation/index.html @@ -47,7 +47,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation

    onCommitted イベントリスナーには 2 つの追加プロパティが渡されます: ナビゲーションの原因 (例えばユーザーがリンクをクリックしたり、ユーザーがブックマークを選んだり) を示す{{WebExtAPIRef("webNavigation.TransitionType","TransitionType")}} と、ナビゲーションの詳細情報を提供する{{WebExtAPIRef("webNavigation.TransitionQualifier","TransitionQualifier")}} です。

    -

    この API を使うには"webNavigation" パーミッションが必要です。

    +

    この API を使うには"webNavigation" パーミッションが必要です。

    @@ -64,7 +64,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation
    {{WebExtAPIRef("webNavigation.getFrame()")}}
    -
    特定フレームについての情報を取得します。フレームにはタブ内のトップレベルのフレームや、ネストされた iframe であり、タブ ID とフレーム ID でユニークに識別されます。
    +
    特定フレームについての情報を取得します。フレームにはタブ内のトップレベルのフレームや、ネストされた iframe であり、タブ ID とフレーム ID でユニークに識別されます。
    {{WebExtAPIRef("webNavigation.getAllFrames()")}}

    タブ ID を指定すると、そのタブに含まれているすべてのフレームの情報を取得します。

    @@ -81,9 +81,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation
    {{WebExtAPIRef("webNavigation.onCommitted")}}
    ナビゲーションがコミットされたときに発火します。少なくともサーバーから新しい document がいくらか取得されてブラウザーが新document に切り替えると決決めたとき。
    {{WebExtAPIRef("webNavigation.onDOMContentLoaded")}}
    -
    ページ内で DOMContentLoaded イベントが発火したときに発火します。
    +
    ページ内で DOMContentLoaded イベントが発火したときに発火します。
    {{WebExtAPIRef("webNavigation.onCompleted")}}
    -
    document と、それが参照するリソースが完全にロードされて初期化されたときに発火します。これは DOM load イベントと等価です。
    +
    document と、それが参照するリソースが完全にロードされて初期化されたときに発火します。これは DOM load イベントと等価です。
    {{WebExtAPIRef("webNavigation.onErrorOccurred")}}
    エラーが起こってナビゲーションが停止したときに発火します。これはネットワークエラーが起きたときや、ユーザーがナビゲーションを停止したときのいずれかで起こりえます。
    {{WebExtAPIRef("webNavigation.onCreatedNavigationTarget")}}
    diff --git a/files/ja/mozilla/add-ons/webextensions/api/webrequest/index.html b/files/ja/mozilla/add-ons/webextensions/api/webrequest/index.html index fba97e5f22..3cb7806512 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/webrequest/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/webrequest/index.html @@ -116,7 +116,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest
    {{WebExtAPIRef("webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES")}}
    -
    10分間に handlerBehaviorChanged() を最大限呼べる回数。
    +
    10分間に handlerBehaviorChanged() を最大限呼べる回数。

    メソッド

    @@ -157,7 +157,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest

    {{Compat("webextensions.api.webRequest")}}

    -

    Extra notes on Chrome incompatibilities.

    +

    Extra notes on Chrome incompatibilities.

    {{WebExtExamples("h2")}}

    diff --git a/files/ja/mozilla/add-ons/webextensions/api/windows/windowstate/index.html b/files/ja/mozilla/add-ons/webextensions/api/windows/windowstate/index.html index a60ce41391..1710048cea 100644 --- a/files/ja/mozilla/add-ons/webextensions/api/windows/windowstate/index.html +++ b/files/ja/mozilla/add-ons/webextensions/api/windows/windowstate/index.html @@ -19,7 +19,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WindowState
    "maximized"
    ウィンドウはシステムエリアやOSによる予約なしに画面を満たしている(最大化)。
    "fullscreen"
    -
    ウィンドウはフルスクリーンアプリケーションとして稼働しているか、タブの内容がFullscreen APIを利用している(全画面)。
    +
    ウィンドウはフルスクリーンアプリケーションとして稼働しているか、タブの内容がFullscreen APIを利用している(全画面)。
    "docked"
    A docked window occupies a fixed position relative to other windows owned by the same application.
    diff --git a/files/ja/mozilla/add-ons/webextensions/chrome_incompatibilities/index.html b/files/ja/mozilla/add-ons/webextensions/chrome_incompatibilities/index.html index 4cff21e91d..cb8ee5e3ab 100644 --- a/files/ja/mozilla/add-ons/webextensions/chrome_incompatibilities/index.html +++ b/files/ja/mozilla/add-ons/webextensions/chrome_incompatibilities/index.html @@ -39,7 +39,7 @@ chrome.cookies);
    -

    同様の WebExtensions API では promises を利用します:

    +

    同様の WebExtensions API では promises を利用します:

    function logCookie(c) {
       console.log(c);
    @@ -62,27 +62,27 @@ setCookie.th
     
     

    部分的にサポートされている API

    -

    ブラウザーの JavaScript API サポートのページには、Firefox でサポートされているすべての API の互換性テーブルが含まれています。特定の API アイテムのサポートに関する警告がある場合は、これらのテーブルにアスタリスク "*" が表示され、API アイテムのリファレンスページにその警告が説明されています。

    +

    ブラウザーの JavaScript API サポートのページには、Firefox でサポートされているすべての API の互換性テーブルが含まれています。特定の API アイテムのサポートに関する警告がある場合は、これらのテーブルにアスタリスク "*" が表示され、API アイテムのリファレンスページにその警告が説明されています。

    このテーブルは、GitHub で JSON ファイルとして保存された互換性データから生成されます。

    このセクションの残りの部分では、テーブルにまだ取り込まれていない互換性の問題について説明します。

    -

    notifications

    +

    notifications

      -
    • notifications.create()"basic" typeを指定した場合の、 iconUrl は Firefox では任意です。Chrome では必須です。
    • +
    • notifications.create()"basic" typeを指定した場合の、 iconUrl は Firefox では任意です。Chrome では必須です。
    • 通知はユーザーがクリックするとすぐに消去されます。 これは Chrome では当てはまりません。
    • notifications.create() を複数回連続して呼び出すと、Firefox が通知を一切表示しなくなることがあります。 chrome.notifications.create() のコールバック関数内に入るまでの時間は、後続のスクリプトが実行されるまで待つほど十分な時間ではありません。
    -

    proxy

    +

    proxy

    • この API は Chrome API の設計とはまったく異なります。 Chrome の API を使用すると、拡張機能で PAC ファイルを登録できますが、明示的なプロキシルールを定義することもできます。これは拡張 PAC ファイルを使用しても可能であるため、この API は PAC ファイルのアプローチのみをサポートしています。 この API は Chrome の proxy API と互換性がないため、この API は browser の名前空間でのみ使用できます。
    -

    tabs

    +

    tabs

    • @@ -97,15 +97,15 @@ setCookie.th
    • Firefox では、beforeunload イベントの後に tabs.remove() の promise が実行されますが、Chrome では コールバック が beforeunload を待ちません。
    -

    webRequest

    +

    webRequest

    • Firefox では、元の URL がhttp:またはhttps:を使用する場合にのみ、リクエストをリダイレクトできます。
    • Firefox では、システム要求(拡張機能のアップグレードや検索バーの提案など)でイベントが発生しません。 Firefox 57以降では、Firefox はプロキシ認証のために{{WebExtAPIRef("webRequest.onAuthRequired")}}を遮断する必要がある拡張機能の例外を生成します。{{WebExtAPIRef("webRequest.onAuthRequired")}}のドキュメントをご覧ください。
    • -
    • Firefox では、拡張機能が外部URL (例 HTTPS) から拡張機能ページにリダイレクトする場合、拡張機能の manifest.json ファイルは、その拡張機能ページの URL を一覧にした web_accessible_resources キーを含むことが必須です。 その URL にあらゆるウェブサイトからリンクやリダイレクトされる可能性があり、拡張機能は、入力データ(例えば POST データ) を、ただ通常のウェブページがそうするように、アントラステッドなソースからとして取り扱うべきであるのに注意します。
    • +
    • Firefox では、拡張機能が外部URL (例 HTTPS) から拡張機能ページにリダイレクトする場合、拡張機能の manifest.json ファイルは、その拡張機能ページの URL を一覧にした web_accessible_resources キーを含むことが必須です。 その URL にあらゆるウェブサイトからリンクやリダイレクトされる可能性があり、拡張機能は、入力データ(例えば POST データ) を、ただ通常のウェブページがそうするように、アントラステッドなソースからとして取り扱うべきであるのに注意します。
    -

    windows

    +

    windows

    • Firefox では、onFocusChanged はフォーカス変更に対して複数回トリガされます。
    • @@ -119,7 +119,7 @@ setCookie.th

      付加的な非互換性

      -

      Firefox は、バックグラウンドページからのalert(), confirm() または prompt()の使用をサポートしていません。

      +

      Firefox は、バックグラウンドページからのalert(), confirm() または prompt()の使用をサポートしていません。

      web_accessible_resources

      @@ -133,11 +133,11 @@ setCookie.th

      コンテンツスクリプトのリクエストは、コンテンツページではなく、拡張機能のコンテキストで発生する

      -

      chrome では、コンテンツスクリプトから/apiのような相対URL にリクエストが呼び出されたとき(たとえば、fetch()を使用して)、https://example.com/apiに送信されます。Firefox では、絶対URL を指定する必要があります。

      +

      chrome では、コンテンツスクリプトから/apiのような相対URL にリクエストが呼び出されたとき(たとえば、fetch()を使用して)、https://example.com/apiに送信されます。Firefox では、絶対URL を指定する必要があります。

      manifest.json のキー

      -

      メインの manifest.json ページには、manifest.json のキーのブラウザーサポートを説明する表が含まれています。 特定のキーのサポートに関する警告がある場合、表にアスタリスク "*"付きで示され、キーのリファレンスページには注意事項が説明されています。

      +

      メインの manifest.json ページには、manifest.json のキーのブラウザーサポートを説明する表が含まれています。 特定のキーのサポートに関する警告がある場合、表にアスタリスク "*"付きで示され、キーのリファレンスページには注意事項が説明されています。

      これらの表は、 GitHub で JSON ファイルとして保存された互換性データから生成されます。

      diff --git a/files/ja/mozilla/add-ons/webextensions/content_scripts/index.html b/files/ja/mozilla/add-ons/webextensions/content_scripts/index.html index ee385edde7..00c2bf1668 100644 --- a/files/ja/mozilla/add-ons/webextensions/content_scripts/index.html +++ b/files/ja/mozilla/add-ons/webextensions/content_scripts/index.html @@ -13,7 +13,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Content_scripts

      通常のウェブページで読み込まれたスクリプトと同様に、コンテンツスクリプトは、標準の DOM API を使用してページのコンテンツを読み取り、変更することができます。

      -

      コンテンツスクリプトは、WebExtension API の小さなサブセット にしかアクセスできませんが、メッセージングシステムを使用して バックグラウンドスクリプトと通信し、WebExtension API に間接的にアクセスすることができます。

      +

      コンテンツスクリプトは、WebExtension API の小さなサブセット にしかアクセスできませんが、メッセージングシステムを使用して バックグラウンドスクリプトと通信し、WebExtension API に間接的にアクセスすることができます。

      コンテンツスクリプトは次のドメインでブロックされるのに注意してください:

      @@ -53,13 +53,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/Content_scripts
    • インストール時に、URL パターンにマッチするページ内へ
      -
      manifest.jsoncontent_scripts キーを使用して、URL が指定されたパターンにマッチするページをロードするたびにコンテンツスクリプトを読み込むようブラウザーに依頼できます。
      +
      manifest.jsoncontent_scripts キーを使用して、URL が指定されたパターンにマッチするページをロードするたびにコンテンツスクリプトを読み込むようブラウザーに依頼できます。
    • 実行時に、URL パターンにマッチするページ内へ
      -
      {{WebExtAPIRef("contentScripts")}} API を使って、URL が指定されたパターンにマッチするページをロードするたびにコンテンツスクリプトを読み込むようブラウザーに依頼できます。これは method (1) のようなもので、違いは実行時にコンテンツスクリプトを追加/削除できることです。
      +
      {{WebExtAPIRef("contentScripts")}} API を使って、URL が指定されたパターンにマッチするページをロードするたびにコンテンツスクリプトを読み込むようブラウザーに依頼できます。これは method (1) のようなもので、違いは実行時にコンテンツスクリプトを追加/削除できることです。
    • @@ -72,7 +72,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Content_scripts

      フレームごと、拡張機能ごとのグローバルスコープしかありません。これは 1 つのコンテンツスクリプトの変数は、読み込み方にかかわらず、他のコンテンツスクリプトからアクセスできることになります。

      -

      方法 (1) と (2) ではマッチパターンを使って表現された URL のスクリプトだけを読み込みできます。

      +

      方法 (1) と (2) ではマッチパターンを使って表現された URL のスクリプトだけを読み込みできます。

      方法 (3) では、拡張機能と一緒にパッケージされたページのスクリプトも読み込みできますが、"about:debugging" や "about:addons"のような権限つきページにはスクリプトを読み込めません。

      @@ -191,12 +191,12 @@ window.confirm("Are you sure?"); // calls the original window.confirm()

    すべてから:

    XHR と Fetch

    -

    コンテンツスクリプトは通常の window.XMLHttpRequestwindow.fetch() API を使ってリクエストを作成できます。

    +

    コンテンツスクリプトは通常の window.XMLHttpRequestwindow.fetch() API を使ってリクエストを作成できます。

    Firefox では、コンテンツスクリプトの (例えば、fetch() を使った) リクエストは、拡張機能のコンテキストで起こるので、ページコンテンツを参照する URL を絶対URL で提供せねばなりません。

    @@ -204,9 +204,9 @@ window.confirm("Are you sure?"); // calls the original window.confirm()

    Chrome では、リクエストはページのコンテキストで起こるので、相対 URL で行われます。例えば、/apihttps://[現在のページの URL]/api に送られます。

    -

    コンテンツスクリプトは拡張機能の他の部分と同一のクロスドメイン権限を取得します: よって拡張機能が manifest.jsonpermissions キーを使ってあるドメインのクロスドメインアクセスを要求している場合、コンテンツスクリプトも同様にそのドメインのアクセスを取得します。

    +

    コンテンツスクリプトは拡張機能の他の部分と同一のクロスドメイン権限を取得します: よって拡張機能が manifest.jsonpermissions キーを使ってあるドメインのクロスドメインアクセスを要求している場合、コンテンツスクリプトも同様にそのドメインのアクセスを取得します。

    -

    これはより多く権限付けられた XHR に晒して、コンテンツスクリプトでインスタンスを取得することで達成し、その副作用としてページ自体からのリクエストがそうであるように OriginReferer ヘッダーがセットされず、リクエストからクロスオリジンな性質を隠すことが好ましいことがよくあります。

    +

    これはより多く権限付けられた XHR に晒して、コンテンツスクリプトでインスタンスを取得することで達成し、その副作用としてページ自体からのリクエストがそうであるように OriginReferer ヘッダーがセットされず、リクエストからクロスオリジンな性質を隠すことが好ましいことがよくあります。

    バージョン 58 以降、コンテンツ自体から送られたかのようなリクエストを必要とする拡張機能は  content.XMLHttpRequestcontent.fetch() を代わりに使うことができます。

    diff --git a/files/ja/mozilla/add-ons/webextensions/content_security_policy/index.html b/files/ja/mozilla/add-ons/webextensions/content_security_policy/index.html index 4bd247cf03..fff9baffd6 100644 --- a/files/ja/mozilla/add-ons/webextensions/content_security_policy/index.html +++ b/files/ja/mozilla/add-ons/webextensions/content_security_policy/index.html @@ -8,7 +8,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Content_Security_Policy
    {{AddonSidebar}}
    -

    WebExtension APIs で開発される拡張機能には、既定で適用される CSP(Content Security Policy の略) があります。これは <script><object> リソースから読み込まれるソースを制限し、危険な行動、例えば eval() の使用を非許可にします。

    +

    WebExtension APIs で開発される拡張機能には、既定で適用される CSP(Content Security Policy の略) があります。これは <script><object> リソースから読み込まれるソースを制限し、危険な行動、例えば eval() の使用を非許可にします。

    この記事では CSP とは何かと、デフォルトポリシーとは何で拡張機能にはどんな意味があるのかと、拡張機能が既定の CSP を変更する方法を簡単に説明します。

    @@ -61,13 +61,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/Content_Security_Policy diff --git a/files/ja/mozilla/add-ons/webextensions/developing_webextensions_for_thunderbird/index.html b/files/ja/mozilla/add-ons/webextensions/developing_webextensions_for_thunderbird/index.html index 319e8e61de..ec7fe9399e 100644 --- a/files/ja/mozilla/add-ons/webextensions/developing_webextensions_for_thunderbird/index.html +++ b/files/ja/mozilla/add-ons/webextensions/developing_webextensions_for_thunderbird/index.html @@ -12,11 +12,11 @@ original_slug: Mozilla/Add-ons/WebExtensions/ThunderbirdにおけるWebExtension

    APIの違い

    両者ともGeckoベースであるため、いくつかの違いはあるものの、Thunderbirdでは、Firefoxで使えるAPIの多くをサポートしています。
    - 詳細は、browser compatibility for manifest.json と browser support for JavaScript APIsを参照してください。

    + 詳細は、browser compatibility for manifest.json と browser support for JavaScript APIsを参照してください。

    参考

    diff --git a/files/ja/mozilla/add-ons/webextensions/extending_the_developer_tools/index.html b/files/ja/mozilla/add-ons/webextensions/extending_the_developer_tools/index.html index 75fdb38e28..29d054ae0b 100644 --- a/files/ja/mozilla/add-ons/webextensions/extending_the_developer_tools/index.html +++ b/files/ja/mozilla/add-ons/webextensions/extending_the_developer_tools/index.html @@ -13,7 +13,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Extending_the_developer_tools
    {{AddonSidebar}}
    -

    このページでは、Firefox 55に存在するdevtools APIについて説明しています。このAPIはChrome devtools APIsに基づいていますが、まだFirefoxでは実装されていないため、ここでは説明していません。現在欠けている機能を確認するには、devtools APIの制限を参照してください。

    +

    このページでは、Firefox 55に存在するdevtools APIについて説明しています。このAPIはChrome devtools APIsに基づいていますが、まだFirefoxでは実装されていないため、ここでは説明していません。現在欠けている機能を確認するには、devtools APIの制限を参照してください。

    WebExtensions API を使用して、ブラウザの組み込み開発者ツールを拡張できます。 devtools 拡張機能を作成するには、manifest.json に "devtools_page" キーを含めます:

    diff --git a/files/ja/mozilla/add-ons/webextensions/implement_a_settings_page/index.html b/files/ja/mozilla/add-ons/webextensions/implement_a_settings_page/index.html index 3c1946e053..7748851616 100644 --- a/files/ja/mozilla/add-ons/webextensions/implement_a_settings_page/index.html +++ b/files/ja/mozilla/add-ons/webextensions/implement_a_settings_page/index.html @@ -50,7 +50,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Implement_a_settings_page

    これは単にページに青い枠をつけます。

    -

    この拡張機能をインストールしてテストします — お好みのあらゆるウェブページを開きます:

    +

    この拡張機能をインストールしてテストします — お好みのあらゆるウェブページを開きます:

    {{EmbedYouTube("E-WUhihF8fw")}}

    @@ -161,7 +161,7 @@ document.querySelector("form").addEventListener("submit", saveOptions);

    ローカルストレージがふさわしいと感じる場合、代わりにローカルストレージに設定値を保存できます。

    -

    Firefox の storage.sync の実装はアドオン ID に依存しているのに注意します。storage.sync を使う場合、上記manifest にあるように、manifest.json の applications キーに拡張機能の ID をセットしておく必要があります。

    +

    Firefox の storage.sync の実装はアドオン ID に依存しているのに注意します。storage.sync を使う場合、上記manifest にあるように、manifest.json の applications キーに拡張機能の ID をセットしておく必要があります。

    最後に、ストレージから枠の色を読むのに "borderify.js" を更新します:

    @@ -197,7 +197,7 @@ getting.then(onGot, onError);

    いま、次を行ってみます:

      -
    • 拡張機能を再読み込み
    • +
    • 拡張機能を再読み込み
    • ウェブページを読み込む
    • 設定ページを開いて枠の色を変える
    • ウェブページを再読み込みして違いを見る
    • diff --git a/files/ja/mozilla/add-ons/webextensions/index.html b/files/ja/mozilla/add-ons/webextensions/index.html index 73ae6f80b2..b8f78cc74b 100644 --- a/files/ja/mozilla/add-ons/webextensions/index.html +++ b/files/ja/mozilla/add-ons/webextensions/index.html @@ -12,7 +12,7 @@ translation_of: Mozilla/Add-ons/WebExtensions

      拡張機能はブラウザーの能力を拡張・修正するものです。Firefox の拡張機能は WebExtensions API を使ってビルドされ、この API は拡張機能をクロスブラウザーで開発するシステムです。このシステムの大半は Google Chrome と Opera と W3C Draft Community Group でサポートされている extension API と互換性があります。

      -

      これらのブラウザー用に書かれた拡張機能は大抵の場合、ほんの少し変更を加えるだけで Firefox や Microsoft Edge でも動かすことができます。この API は マルチプロセス Firefox にも完全互換です。

      +

      これらのブラウザー用に書かれた拡張機能は大抵の場合、ほんの少し変更を加えるだけで Firefox や Microsoft Edge でも動かすことができます。この API は マルチプロセス Firefox にも完全互換です。

      お持ちのアイデアや質問があったり、レガシーアドオンを WebExtensions API を使うように移行するのに助けが要る場合、dev-addons のメーリングリスト (英語) や Add-ons room (英語) や Matrix (英語) にてご連絡ください。

      @@ -23,7 +23,7 @@ translation_of: Mozilla/Add-ons/WebExtensions

      始めましょう

        -
      • 拡張機能とは何か?
      • +
      • 拡張機能とは何か?
      • 初めての拡張機能
      • 2 つめの拡張機能
      • 拡張機能の中身
      • diff --git a/files/ja/mozilla/add-ons/webextensions/internationalization/index.html b/files/ja/mozilla/add-ons/webextensions/internationalization/index.html index 368cba4d29..c0c1694a5d 100644 --- a/files/ja/mozilla/add-ons/webextensions/internationalization/index.html +++ b/files/ja/mozilla/add-ons/webextensions/internationalization/index.html @@ -382,7 +382,7 @@ padding-left: 1.5em;

        あなたの拡張機能をテストする

        -

        Firefox 45 からは、拡張機能を一時的にディスクからインストールできます — ディスクから読み込むを見てください。これを行ってから、notify-link-clicks-i18n 拡張機能をテストしてみます。お好きなウェブサイトに移動してクリックしたリンクの URL を報告した通知が出てくるか見てください。

        +

        Firefox 45 からは、拡張機能を一時的にディスクからインストールできます — ディスクから読み込むを見てください。これを行ってから、notify-link-clicks-i18n 拡張機能をテストしてみます。お好きなウェブサイトに移動してクリックしたリンクの URL を報告した通知が出てくるか見てください。

        次に、Firefox のロケールをテストしたい拡張機能がサポートするものに変えます。

        diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/author/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/author/index.html index 979997cce2..c0f3959b7c 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/author/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/author/index.html @@ -29,7 +29,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/author -

        拡張機能の作者で、ブラウザーの UI で表示されることを目的とするものです。developer キーが与えられてそこに "name" プロパティが含まれる場合、それは author キーを上書きします。複数の作者を指定する方法はありません。

        +

        拡張機能の作者で、ブラウザーの UI で表示されることを目的とするものです。developer キーが与えられてそこに "name" プロパティが含まれる場合、それは author キーを上書きします。複数の作者を指定する方法はありません。

        これはローカライズ可能なプロパティです。

        diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/background/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/background/index.html index 5397e8d919..e6dabc8e88 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/background/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/background/index.html @@ -87,7 +87,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/background
        • true を指定すると、拡張機能が読み込まれるかブラウザーが起動した時から、拡張機能の削除、無効化、もしくはブラウザーが終了するまでの間、バックグラウンドページがメモリー上に保持され続けます(つまり、バックグラウンドページが永続化されます)。
        • -
        • false を指定すると、バックグラウンドページはアイドル状態の時にメモリー上からアンロードされ、必要に応じて再生成されます。このようなバックグラウンドページは、リスナーを登録したイベントを処理するためだけにメモリー上に読み込まれるため、イベントページとも呼ばれます。バックグラウンドページがメモリ上からアンロードされていても、リスナーの登録状態は永続化されますが、他の値は永続化されません。イベントページにおいてデータを永続化したい場合は、storage APIを使う必要があります。
        • +
        • false を指定すると、バックグラウンドページはアイドル状態の時にメモリー上からアンロードされ、必要に応じて再生成されます。このようなバックグラウンドページは、リスナーを登録したイベントを処理するためだけにメモリー上に読み込まれるため、イベントページとも呼ばれます。バックグラウンドページがメモリ上からアンロードされていても、リスナーの登録状態は永続化されますが、他の値は永続化されません。イベントページにおいてデータを永続化したい場合は、storage APIを使う必要があります。
        diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_action/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_action/index.html index 3b0dba68a6..a5723c6d5b 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_action/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_action/index.html @@ -48,7 +48,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/browser_action

        browser actionはあなたのブラウザーのツールバーに拡張機能のボタンを追加します。ボタンはアイコンと、オプションでHTML、CSSとJavaScriptを使用した、ポップアップコンテンツを使用できます。

        -

        ポップアップを提供する場合は、ユーザーがボタンをクリックしたときポップアップが開かれ、ポップアップで実行されているJavaScriptは、ユーザーの実行を処理できます。ポップアップを提供しない場合、ユーザーがボタンをクリックすると、クリックイベントが拡張機能のバックグラウンドスクリプトに送信されます。

        +

        ポップアップを提供する場合は、ユーザーがボタンをクリックしたときポップアップが開かれ、ポップアップで実行されているJavaScriptは、ユーザーの実行を処理できます。ポップアップを提供しない場合、ユーザーがボタンをクリックすると、クリックイベントが拡張機能のバックグラウンドスクリプトに送信されます。

        You can also create and manipulate browser actions programmatically using the browserAction API.

        diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.html index 577e491a54..fa16b0965e 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.html @@ -19,7 +19,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_set 必須 -

        通常は不要です ( いつ Add-on ID が必要か?を参考に) 。Firefox 48 より前と Android版Firefox では必須です。

        +

        通常は不要です ( いつ Add-on ID が必要か?を参考に) 。Firefox 48 より前と Android版Firefox では必須です。

        @@ -46,7 +46,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_set

        現在、4 つの文字列属性を含む gecko キーのみが存在します。

          -
        • id拡張機能ID です。Firefox 48 からオプションですが、Firefox 48 より前では必須です。いつ特定の add-on ID が必要になるかについては、拡張機能と Add-on ID を見てください。
        • +
        • id拡張機能ID です。Firefox 48 からオプションですが、Firefox 48 より前では必須です。いつ特定の add-on ID が必要になるかについては、拡張機能と Add-on ID を見てください。
        • strict_min_version: サポートする Gecko の最小バージョンです。"*" を含むバージョンは、このフィールドでは無効です。既定は "42a1" です。
        • strict_max_version: サポートする Gecko の最大バージョンです。拡張機能がこのバージョンを超えた Firefox のバージョンにインストールや実行された場合、拡張機能は無効または、インストールが許可されません。既定は "*" で、最大バージョンのチェックは無効です。
        • update_urladd-on update manifest へのリンクです。リンクは "https" で始まっている必要があることに注意してください。このキーは拡張機能が自分自身で更新を管理するためのものです(つまり AMO以外で)。
        • diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/chrome_url_overrides/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/chrome_url_overrides/index.html index e3d91ef552..209284f3b4 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/chrome_url_overrides/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/chrome_url_overrides/index.html @@ -82,7 +82,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides -

          すべてのプロパティはローカライズ可能です

          +

          すべてのプロパティはローカライズ可能です

          diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/description/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/description/index.html index 9f8374985c..3951be0947 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/description/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/description/index.html @@ -31,7 +31,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/description

          ブラウザーのユーザーインターフェースに表示するための、拡張機能の簡単な説明です。

          -

          これはローカライズ可能なプロパティです。

          +

          これはローカライズ可能なプロパティです。

          diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/homepage_url/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/homepage_url/index.html index 64e36c0f53..018dd055f0 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/homepage_url/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/homepage_url/index.html @@ -31,7 +31,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/homepage_url

          拡張機能のホームページの URL です。

          -

          developer キーが提供されていて、そこに "url" プロパティが含まれている場合、homepage_url キーは上書きされます。

          +

          developer キーが提供されていて、そこに "url" プロパティが含まれている場合、homepage_url キーは上書きされます。

          これは国際化できるプロパティです。

          diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/index.html index 34274940de..610c9c222f 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/index.html @@ -13,7 +13,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json

          manifest.json を使うことで、拡張機能の名前やバージョンといった基本的なメタデータを指定したり、拡張機能の機能的な側面として、例えばバックグラウンドスクリプトやコンテンツスクリプト、ブラウザーアクションを指定することもできます。

          -

          これは JSON形式のファイルですが、1つ例外があります: "//"-形式のコメントが許可されています。

          +

          これは JSON形式のファイルですが、1つ例外があります: "//"-形式のコメントが許可されています。

          manifest.json のキー一覧は次の通り:

          @@ -41,7 +41,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json

          注: これはコピー・ペーストできるような使われ方のつもりではないのに注意してください: どのキーが必要かは開発している拡張機能に依存します。

    -

    完全な例は Example extensions を見てください。

    +

    完全な例は Example extensions を見てください。

    {
       "applications": {
    @@ -116,7 +116,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json
     
     

    ブラウザーの実装状況

    -

    マニフェストキーとサブキーのすべてを見るには、完全な manifest.json ブラウザー互換テーブルを見てください。

    +

    マニフェストキーとサブキーのすべてを見るには、完全な manifest.json ブラウザー互換テーブルを見てください。

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/options_ui/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/options_ui/index.html index 5d49d029eb..4ef2abbd14 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/options_ui/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/options_ui/index.html @@ -35,9 +35,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/options_ui

    オプションページは、拡張機能の設定を含みます。オプションページはブラウザーのアドオンマネージャー、または拡張機能内で {{WebExtAPIRef("runtime.openOptionsPage()")}} を使用することでアクセスできます。

    -

    options_ui を拡張機能にパッケージされた HTML ファイルへのパスとして指定します。通常のウェブページのように、HTML、CSS、JavaScript ファイルを含めることができます。しかし、通常のページと異なり、拡張機能が権限を持つすべての WebExtension API を使用できます。しかし、バックグラウンドスクリプトとは異なるスコープで実行されます。

    +

    options_ui を拡張機能にパッケージされた HTML ファイルへのパスとして指定します。通常のウェブページのように、HTML、CSS、JavaScript ファイルを含めることができます。しかし、通常のページと異なり、拡張機能が権限を持つすべての WebExtension API を使用できます。しかし、バックグラウンドスクリプトとは異なるスコープで実行されます。

    -

    オプションページバックグラウンドスクリプトの JavaScript 上で、データや関数を共有したい場合、{{WebExtAPIRef("extension.getBackgroundPage()")}} を使用してバックグラウンドスクリプトの Window への参照を直接取得するか、{{WebExtAPIRef("extension.getViews()")}} で拡張機能内で実行されているいずれかのページの {{domxref("Window")}} を取得します。あるいは、JavaScript で runtime.sendMessage()runtime.onMessageruntime.connect() を使用することで、オプションページとバックグラウンドスクリプト間で相互にコミュニケーションできます。後者の方法 (や同等の runtime.Port ) でも バックグラウンドスクリプトコンテンツスクリプトとでオプションを共有できます。

    +

    オプションページバックグラウンドスクリプトの JavaScript 上で、データや関数を共有したい場合、{{WebExtAPIRef("extension.getBackgroundPage()")}} を使用してバックグラウンドスクリプトの Window への参照を直接取得するか、{{WebExtAPIRef("extension.getViews()")}} で拡張機能内で実行されているいずれかのページの {{domxref("Window")}} を取得します。あるいは、JavaScript で runtime.sendMessage()runtime.onMessageruntime.connect() を使用することで、オプションページとバックグラウンドスクリプト間で相互にコミュニケーションできます。後者の方法 (や同等の runtime.Port ) でも バックグラウンドスクリプトコンテンツスクリプトとでオプションを共有できます。

    一般的に、オプションページで変更されたオプションは、storage API を使用して、storage.sync (ユーザーがログインしているすべてのブラウザーインスタンス間で設定を同期する場合) か storage.local (現在のマシン / プロファイルのローカル設定にする場合) のいずれかに保存します。バックグラウンドスクリプトに変更を通知する必要がある場合、バックグラウンドスクリプトで storage.onChanged にリスナーを追加します。

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/permissions/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/permissions/index.html index a139d5c23a..2187d98bec 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/permissions/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/permissions/index.html @@ -78,7 +78,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/permissions

    API 権限

    -

    API 権限には、拡張機能から使用したい WebExtension API の名前をキーワードとして指定します。

    +

    API 権限には、拡張機能から使用したい WebExtension API の名前をキーワードとして指定します。

    現時点で使用できるキーワードは以下の通りです。

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/protocol_handlers/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/protocol_handlers/index.html index f0b3e15f5a..5506ad6991 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/protocol_handlers/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/protocol_handlers/index.html @@ -57,7 +57,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/protocol_handlers
    name
    プロトコルハンドラーを表す文字列。これはユーザーがハンドラーにリンクを開くかどうか問い合わせた時に、ユーザーに表示されます。
    uriTemplate
    -
    ハンドラーの URL を表す。この文字列はプレースホルダーとして "%s" を入れる必要があります: これは処理される文書の URL がエスケープされたもので置き換えられます。この URL は本当の URL や電話番号、電子メールアドレス、などです。これはローカライズ可能なプロパティです。
    +
    ハンドラーの URL を表す。この文字列はプレースホルダーとして "%s" を入れる必要があります: これは処理される文書の URL がエスケープされたもので置き換えられます。この URL は本当の URL や電話番号、電子メールアドレス、などです。これはローカライズ可能なプロパティです。

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/sidebar_action/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/sidebar_action/index.html index 7fe517832c..e815b8789a 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/sidebar_action/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/sidebar_action/index.html @@ -98,7 +98,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action

    このプロパティは必須です。

    -

    これはローカライズ可能なプロパティです。

    +

    これはローカライズ可能なプロパティです。

    @@ -107,9 +107,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action

    サイドバーのタイトル。これはブラウザーのUIの中でサイドバーを一覧したり開くのに使われ、サイドバーが開いた時には上に表示されます。

    -

    This property is optional: if it is omitted, the sidebar's title is the extension's name.

    +

    This property is optional: if it is omitted, the sidebar's title is the extension's name.

    -

    This is a localizable property.

    +

    This is a localizable property.

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/theme/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/theme/index.html index 9595d7d2b1..72a48a7615 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/theme/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/theme/index.html @@ -9,7 +9,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/theme
    {{AddonSidebar}}
    -

    Note that you can't yet submit static WebExtension-based themes to addons.mozilla.org. The work to support this is tracked in https://github.com/mozilla/addons/issues/501. If you want to share a theme with other users, you'll need to make it either a lightweight theme or a dynamic theme.

    +

    Note that you can't yet submit static WebExtension-based themes to addons.mozilla.org. The work to support this is tracked in https://github.com/mozilla/addons/issues/501. If you want to share a theme with other users, you'll need to make it either a lightweight theme or a dynamic theme.

    @@ -160,7 +160,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/theme

    These properties define the colors used for different parts of the browser. They are all optional except "accentcolor" and "textcolor" where either those properties or their chrome counterparts have to be specified.

    -

    All these properties can be specified as either a string containing any valid CSS color string (including hexadecimal), or an RGB array, such as "tab_text": [ 107 , 99 , 23 ]. But note that in Chrome, colors may only be specified as an RGB array.

    +

    All these properties can be specified as either a string containing any valid CSS color string (including hexadecimal), or an RGB array, such as "tab_text": [ 107 , 99 , 23 ]. But note that in Chrome, colors may only be specified as an RGB array.

    See the example screenshot below to understand the parts of the browser UI that are affected by these properties.

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/version/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/version/index.html index 1509b55e71..9fddf82a7f 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/version/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/version/index.html @@ -31,7 +31,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/version
    -

    ドットで区切られた数字と ASCII 文字でフォーマットされた拡張機能のバージョンです。バージョンのフォーマットの詳細は Version format ページを見てください。

    +

    ドットで区切られた数字と ASCII 文字でフォーマットされた拡張機能のバージョンです。バージョンのフォーマットの詳細は Version format ページを見てください。

    Chrome の version 定義の構文は、Firefox のものよりも制限が厳しいことに注意してください。

    @@ -40,7 +40,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/version
  • Firefox で有効な version の値は Chrome でも有効とは限りません。
  • -

    AMOキュー内でバージョンを "beta" にマークする特別ルールについては maintenance policy を見てください。

    +

    AMOキュー内でバージョンを "beta" にマークする特別ルールについては maintenance policy を見てください。

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/version_name/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/version_name/index.html index 1abd3a61f2..96ca61e667 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/version_name/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/version_name/index.html @@ -29,7 +29,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/version_name -

    アップデート目的で使われる version 項目に加えて、version_name はバージョン説明の文字列をセットできて、存在する場合は表示目的に使われます。

    +

    アップデート目的で使われる version 項目に加えて、version_name はバージョン説明の文字列をセットできて、存在する場合は表示目的に使われます。

    version_name が存在しない場合、version 項目が同様な表示目的で使われます。

    diff --git a/files/ja/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.html b/files/ja/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.html index 3adb36d237..8cf3b3e987 100644 --- a/files/ja/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.html +++ b/files/ja/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.html @@ -55,7 +55,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/web_accessible_resou images/ my-image.png
    -

    ウェブページに、この画像を指す src 属性のある <img> 要素を入れるには、 "web_accessible_resources" で次のように指定します:

    +

    ウェブページに、この画像を指す src 属性のある <img> 要素を入れるには、 "web_accessible_resources" で次のように指定します:

    "web_accessible_resources": ["images/my-image.png"]
    diff --git a/files/ja/mozilla/add-ons/webextensions/modify_a_web_page/index.html b/files/ja/mozilla/add-ons/webextensions/modify_a_web_page/index.html index daad4f467b..9a2d92b0b8 100644 --- a/files/ja/mozilla/add-ons/webextensions/modify_a_web_page/index.html +++ b/files/ja/mozilla/add-ons/webextensions/modify_a_web_page/index.html @@ -45,7 +45,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Modify_a_web_page } -

    content_scripts キーは URL パターンと一致するページにスクリプトを読み込む方法です。この場合、content_scripts https://developer.mozilla.org/ 以下のすべてのページで "page-eater.js" というスクリプトをロードするようにブラウザーに指示します。

    +

    content_scripts キーは URL パターンと一致するページにスクリプトを読み込む方法です。この場合、content_scripts https://developer.mozilla.org/ 以下のすべてのページで "page-eater.js" というスクリプトをロードするようにブラウザーに指示します。

    content_scripts"js" プロパティ は配列なので、マッチしているページに複数のスクリプトを挿入できます。これを行うと、ページによってロードされるいくつかのスクリプトと同じように、ページは同じスコープを共有し、配列にリストされている順序でロードされます。

    @@ -63,7 +63,7 @@ var header = document.createElement('h1'); header.textContent = "This page has been eaten"; document.body.appendChild(header); -

    拡張機能をインストール して https://developer.mozilla.org/ を訪れてみましょう。

    +

    拡張機能をインストール して https://developer.mozilla.org/ を訪れてみましょう。

    {{EmbedYouTube("lxf2Tkg6U1M")}}

    @@ -126,7 +126,7 @@ browser.contextMenus.onClicked.addListener(function(info, tab) { manifest.json page-eater.js -

    拡張機能を再読み込みして、ページを開きます (任意のページ)  コンテキストメニューを有効化し、"Eat this page" を選択します。

    +

    拡張機能を再読み込みして、ページを開きます (任意のページ)  コンテキストメニューを有効化し、"Eat this page" を選択します。

    {{EmbedYouTube("zX4Bcv8VctA")}}

    diff --git a/files/ja/mozilla/add-ons/webextensions/native_manifests/index.html b/files/ja/mozilla/add-ons/webextensions/native_manifests/index.html index 079e34adc0..6edd032adf 100644 --- a/files/ja/mozilla/add-ons/webextensions/native_manifests/index.html +++ b/files/ja/mozilla/add-ons/webextensions/native_manifests/index.html @@ -92,9 +92,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/Native_manifests allowed_extensions Array of String -

    Add-on ID の配列です。配列中のそれぞれの値はこのネイティブアプリケーションとの通信が許可されている拡張機能を表します。

    +

    Add-on ID の配列です。配列中のそれぞれの値はこのネイティブアプリケーションとの通信が許可されている拡張機能を表します。

    -

    つまり、作成する拡張機能の manifest.json ファイルに applications キーを含めたくなるものと思われるため、開発中に明示的なIDを設定しておくと良いでしょう。

    +

    つまり、作成する拡張機能の manifest.json ファイルに applications キーを含めたくなるものと思われるため、開発中に明示的なIDを設定しておくと良いでしょう。

    @@ -129,7 +129,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Native_manifests name String -

    ストレージにアクセスできる拡張機能の ID で、拡張機能の applications キーで指定したのと同じものです。

    +

    ストレージにアクセスできる拡張機能の ID で、拡張機能の applications キーで指定したのと同じものです。

    diff --git a/files/ja/mozilla/add-ons/webextensions/native_messaging/index.html b/files/ja/mozilla/add-ons/webextensions/native_messaging/index.html index 4f8ec385e0..719e59a30a 100644 --- a/files/ja/mozilla/add-ons/webextensions/native_messaging/index.html +++ b/files/ja/mozilla/add-ons/webextensions/native_messaging/index.html @@ -74,7 +74,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Native_messaging

    アプリマニフェストファイルはネイティブアプリケーションと一緒にインストールする必要があります。ブラウザーはアプリマニフェストファイルを読み込み、検証を行いますが、インストールや管理は行いません。したがって、app manifest ファイルがインストール・アップデートされた時期や方法についてのセキュリティモデルは、WebExtension を使う拡張機能に対してのものというよりはネイティブアプリケーションに対してのものです。

    -

    native アプリマニフェストの文法と場所については、Native manifests を見てください。

    +

    native アプリマニフェストの文法と場所については、Native manifests を見てください。

    例として、"ping_pong"ネイティブアプリケーションの manifest を以下に示します。

    @@ -112,7 +112,7 @@ python -u "c:\\path\\to\\native-messaging\\app\\ping_pong.py"

    拡張機能側

    -

    ネイティブメッセージはコンテンツスクリプトで直接使うことはできません; バックグラウンドスクリプトで間接的にやりとりする必要があります。

    +

    ネイティブメッセージはコンテンツスクリプトで直接使うことはできません; バックグラウンドスクリプトで間接的にやりとりする必要があります。

    これを使うには2つのパターンがあります:ネクションベースのメッセージングとコネクションレスメッセージングです。

    @@ -124,7 +124,7 @@ python -u "c:\\path\\to\\native-messaging\\app\\ping_pong.py"
    @@ -176,7 +176,7 @@ browser.browserAction.onClicked.addListener(() => {
    • アプリマニフェストの完全パス
    • -
    • (Firefox 55 以降で) 起動元のアドオンの ID (manifest.json の applications キーにて指定)
    • +
    • (Firefox 55 以降で) 起動元のアドオンの ID (manifest.json の applications キーにて指定)

    アプリからの最初のメッセージは sendNativeMessage() 呼び出しの応答として扱われ、コールバックに渡されます。

    @@ -355,7 +355,7 @@ while True:
    •  runtime.connectNative() に渡した名前がアプリマニフェスト中の名前と一致しているか確認してください
    • OS X/Linux: アプリマニフェストのファイル名が <name>.json となっていることを確認してください
    • -
    • OS X/Linux: ネイティブアプリのマニフェストの場所がここで述べているところにあるのを確認してください
    • +
    • OS X/Linux: ネイティブアプリのマニフェストの場所がここで述べているところにあるのを確認してください
    • Windows: レジストリキーが正しい場所にあり、その名前がアプリマニフェスト中の名前と一致していることを確認してください
    • Windows: レジストリキーに指定されたパスがアプリマニフェストを指していることを確認してください
    diff --git a/files/ja/mozilla/add-ons/webextensions/user_interface/browser_action/index.html b/files/ja/mozilla/add-ons/webextensions/user_interface/browser_action/index.html index 64b172591a..48e85bc287 100644 --- a/files/ja/mozilla/add-ons/webextensions/user_interface/browser_action/index.html +++ b/files/ja/mozilla/add-ons/webextensions/user_interface/browser_action/index.html @@ -9,11 +9,11 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Browser_action

    よくブラウザーアクションとして参照され、 このユーザーインターフェイスオプションはブラウザーのツールバーに追加されるボタンです。 ユーザーはボタンをクリックして拡張機能とやりとりします。

    -

    ツールバーボタン (ブラウザーアクション) はアドレスバーボタン (ページアクション)とよく似ています。違いといつ使うかについてのガイダンスは、ページアクションとブラウザーアクションを見てください。

    +

    ツールバーボタン (ブラウザーアクション) はアドレスバーボタン (ページアクション)とよく似ています。違いといつ使うかについてのガイダンスは、ページアクションとブラウザーアクションを見てください。

    ブラウザーアクションを指定する

    -

    ブラウザーアクションのプロパティは manifest.json の browser_action キーで定義します。

    +

    ブラウザーアクションのプロパティは manifest.json の browser_action キーで定義します。

    "browser_action": {
       "default_icon": {
    @@ -25,7 +25,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Browser_action
     
     

    唯一不可欠なキーは default_icon です。

    -

    ブラウザーアクションの指定には 2 つの方法があります: ポップアップがつくのとつかないのです。 ポップアップを指定しないと、ユーザーがボタンをクリックした時に、拡張機能にイベントがディスパッチされ、これを拡張機能が browserAction.onClicked を使ってリッスンします:

    +

    ブラウザーアクションの指定には 2 つの方法があります: ポップアップがつくのとつかないのです。 ポップアップを指定しないと、ユーザーがボタンをクリックした時に、拡張機能にイベントがディスパッチされ、これを拡張機能が browserAction.onClicked を使ってリッスンします:

    browser.browserAction.onClicked.addListener(handleClick);
    @@ -33,7 +33,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Browser_action

    拡張機能は 1 つだけのブラウザーアクションを持つ必要があります。

    -

    なお、上に示されている任意のプロパティは browserAction API を使ったコードからも変更できます。

    +

    なお、上に示されている任意のプロパティは browserAction API を使ったコードからも変更できます。

    アイコン

    diff --git a/files/ja/mozilla/add-ons/webextensions/user_interface/devtools_panels/index.html b/files/ja/mozilla/add-ons/webextensions/user_interface/devtools_panels/index.html index 2df3fb0641..365eff5d3d 100644 --- a/files/ja/mozilla/add-ons/webextensions/user_interface/devtools_panels/index.html +++ b/files/ja/mozilla/add-ons/webextensions/user_interface/devtools_panels/index.html @@ -20,9 +20,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/devtools_panels

    開発ツールパネルを指定する

    -

    開発ツールパネルは devtools.panels API を使って追加され、特別な開発ツールページから順番に実行されます。

    +

    開発ツールパネルは devtools.panels API を使って追加され、特別な開発ツールページから順番に実行されます。

    -

    開発ツールのページを追加するには、拡張機能の manifest.jsondevtools_page キーを入れて、 拡張機能内のそのページの HTML ファイルの場所を与えます:

    +

    開発ツールのページを追加するには、拡張機能の manifest.jsondevtools_page キーを入れて、 拡張機能内のそのページの HTML ファイルの場所を与えます:

    "devtools_page": "devtools-page.html"
    @@ -51,7 +51,7 @@ browser.devtools.panels.create( newPanel.onHidden.addListener(handleHidden); });
    -

    拡張機能はインスペクターウィンドウの中で devtools.inspectedWindow.eval() を使うか、バックグラウンドスクリプトからメッセージを渡してコンテンツスクリプトに挿入することで、コードを実行できます。この方法のより詳しくは Extending the developer tools を見てください。

    +

    拡張機能はインスペクターウィンドウの中で devtools.inspectedWindow.eval() を使うか、バックグラウンドスクリプトからメッセージを渡してコンテンツスクリプトに挿入することで、コードを実行できます。この方法のより詳しくは Extending the developer tools を見てください。

    開発パネルのデザイン

    diff --git a/files/ja/mozilla/add-ons/webextensions/user_interface/extension_pages/index.html b/files/ja/mozilla/add-ons/webextensions/user_interface/extension_pages/index.html index 08210629f2..53bb66dfcb 100644 --- a/files/ja/mozilla/add-ons/webextensions/user_interface/extension_pages/index.html +++ b/files/ja/mozilla/add-ons/webextensions/user_interface/extension_pages/index.html @@ -59,7 +59,7 @@ var creating = browser.windows.create(createData); browser.history.onVisited.addListener(onVisited); -

    History API を使には manifest.json で "history" パーミッション をリクエストする必要があります。

    +

    History API を使には manifest.json で "history" パーミッション をリクエストする必要があります。

    ウェブページのデザイン

    diff --git a/files/ja/mozilla/add-ons/webextensions/user_interface/index.html b/files/ja/mozilla/add-ons/webextensions/user_interface/index.html index 0b7cd819de..47979aecc1 100644 --- a/files/ja/mozilla/add-ons/webextensions/user_interface/index.html +++ b/files/ja/mozilla/add-ons/webextensions/user_interface/index.html @@ -26,56 +26,56 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface -

    ブラウザーツールバーボタン(ブラウザーアクション)

    +

    ブラウザーツールバーボタン(ブラウザーアクション)

    ブラウザーツールバーのボタンで、クリック時に機能拡張にイベントを送る。既定では全てのタブででこのボタンが表示されている。 Example showing a toolbar button (browser action). -

    ポップアップ付きのツールバーボタン

    +

    ポップアップ付きのツールバーボタン

    ボタンがクリックされた時の、ブラウザーツールバーのボタン上のポップアップ。ポップアップは、ユーザーインタラクションを扱う HTML 文書内で定義される。 Example of the pop-up on a toolbar button -

    アドレスバーボタン(ページアクション)

    +

    アドレスバーボタン(ページアクション)

    ブラウザーアドレスバー上のボタンで、クリック時に機能拡張にイベントを送る。既定では、全てのタブでこのボタンは非表示。 Example showing an address bar button (page action) - ポップアップ付きのアドレスバーボタン + ポップアップ付きのアドレスバーボタン

    ブラウザーアドレスバーのボタン上のポップアップで、クリック時に開く。ポップアップは、ユーザーインタラクションを扱う HTML 文書内で定義される。

    Example of a popup on the address bar button - コンテキストメニュー項目 + コンテキストメニュー項目 ブラウザーのコンテキストメニュー上の、メニュー項目や、チェックボックスや、ラジオボタン。また、メニューはセパレーターを追加して構造化もできる。メニュー項目がクリックされたとき、機能拡張にイベントが送られる。 Example of content menu items added by a WebExtension, from the context-menu-demo example - サイドバー + サイドバー

    ウェブページの隣に表示される HTML 文書で、ページ毎に固有なコンテンツを持つ。サイドバーは機能拡張がインストールされた時に開かれて、ユーザーのサイドバー可視化の選択に従う。サイドバー内のユーザーインタラクションは HTML 文書によって扱われる。

    Example of a sidebar - オプションページ + オプションページ 機能拡張に対してユーザーが変更できる設定値を決めるページ。ユーザーはブラウザーのアドオンマネージャーからこのページにアクセスできる。 Example showing the options page content added in the favorite colors example. - Extension page + Extension page ウィンドウやタブの中で、フォームやヘルプやその他必要となるあらゆるコンテンツを提供するには、機能拡張に含めたウェブページを使います。 Example of a simple bundled page displayed as a detached panel. - 通知 + 通知 OS の通知の仕組みを通じてユーザーに表示される一時的な通知。ユーザーが通知をクリックした時や、(自動的に、あるいはユーザーが要求した場合の両方に)通知が閉じた時、機能拡張にイベントを送る。 Example of an extension triggered system notification @@ -85,7 +85,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface Example showing the result of the firefox_code_search WebExtension's customization of the address bar suggestions. - 開発ツールパネル + 開発ツールパネル ブラウザーの開発ツール内で表示される、タブと関連 HTML 文書。 Example showing the result of the firefox_code_search WebExtension's customization of the address bar suggestions. @@ -96,8 +96,8 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface diff --git a/files/ja/mozilla/add-ons/webextensions/user_interface/options_pages/index.html b/files/ja/mozilla/add-ons/webextensions/user_interface/options_pages/index.html index 524223bc00..150ebb72f6 100644 --- a/files/ja/mozilla/add-ons/webextensions/user_interface/options_pages/index.html +++ b/files/ja/mozilla/add-ons/webextensions/user_interface/options_pages/index.html @@ -17,8 +17,8 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Options_pages
    -

    このページは、プログラムから runtime.openOptionsPage() を呼び出して開くこともできます。

    -オプションページにおけるリソースの読み込み元や、eval() のように安全でない処理は Content Security Policy によって制限されます。詳細は Content Security Policy を参照してください。 +

    このページは、プログラムから runtime.openOptionsPage() を呼び出して開くこともできます。

    +オプションページにおけるリソースの読み込み元や、eval() のように安全でない処理は Content Security Policy によって制限されます。詳細は Content Security Policy を参照してください。

    オプションページを指定する

    @@ -42,18 +42,18 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Options_pages </html> -

    ページ内で動く JavaScript はアドオンが権限を持つすべての WebExtension APIs を使うことができます。特に、設定を保管する storage API を使えます。

    +

    ページ内で動く JavaScript はアドオンが権限を持つすべての WebExtension APIs を使うことができます。特に、設定を保管する storage API を使えます。

    ページファイルを拡張機能の中にパッケージします.

    -

    manifest.json 内に options_ui キーも必要です、ここではページの URL を与えます。

    +

    manifest.json 内に options_ui キーも必要です、ここではページの URL を与えます。

    "options_ui": {
       "page": "options.html",
       "browser_style": true
     },
    -

    options_ui ページを見てオプションページとバックグラウンド/コンテンツスクリプトとの間でオプションを共有することができます。

    +

    options_ui ページを見てオプションページとバックグラウンド/コンテンツスクリプトとの間でオプションを共有することができます。

    オプションコンテンツのデザイン

    diff --git a/files/ja/mozilla/add-ons/webextensions/user_interface/page_actions/index.html b/files/ja/mozilla/add-ons/webextensions/user_interface/page_actions/index.html index c285ad2670..2867a7f679 100644 --- a/files/ja/mozilla/add-ons/webextensions/user_interface/page_actions/index.html +++ b/files/ja/mozilla/add-ons/webextensions/user_interface/page_actions/index.html @@ -12,13 +12,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Page_actions

    -

    ウェブページに関係する機能のある時だけにこのボタンを使ってください。既定ではアドレスバーのボタンはすべてのタブにて隠されていて、pageAction.show()pageAction.hide() を呼び出すことで、特定のタブ上での表示・非表示を制御します。

    +

    ウェブページに関係する機能のある時だけにこのボタンを使ってください。既定ではアドレスバーのボタンはすべてのタブにて隠されていて、pageAction.show()pageAction.hide() を呼び出すことで、特定のタブ上での表示・非表示を制御します。

    ツールバーボタンと比較して、似た振る舞いをしますが、そちらは拡張機能の機能が大抵のウェブページに適用できる状況で使われます。

    ページアクションを指定する

    -

    ページアクションのプロパティは manifest.json の page_action キーで定義します。

    +

    ページアクションのプロパティは manifest.json の page_action キーで定義します。

    "page_action": {
       "browser_style": true,
    @@ -31,15 +31,15 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Page_actions
     
     

    唯一不可欠なキーは default_icon です。

    -

    ページアクションの指定には2つの方法があります: ポップアップがつくのとつかないのです。 ポップアップを指定しないと、ユーザーがボタンをクリックした時に、拡張機能にイベントがディスパッチされ、これを拡張機能が pageAction.onClickedを使ってリッスンします:

    +

    ページアクションの指定には2つの方法があります: ポップアップがつくのとつかないのです。 ポップアップを指定しないと、ユーザーがボタンをクリックした時に、拡張機能にイベントがディスパッチされ、これを拡張機能が pageAction.onClickedを使ってリッスンします:

    browser.pageAction.onClicked.addListener(handleClick);
    -

    ポップアップを指定すると、クリックイベントはディスパッチされません: その代わりに、ユーザーがボタンをクリックした時にポップアップが表示されます。ユーザーはポップアップとやりとりできて、ユーザーが範囲外をクリックした時に自動的にポップアップが閉じます。ポップアップを作成、管理することの詳細はポップアップの記事を見てください。

    +

    ポップアップを指定すると、クリックイベントはディスパッチされません: その代わりに、ユーザーがボタンをクリックした時にポップアップが表示されます。ユーザーはポップアップとやりとりできて、ユーザーが範囲外をクリックした時に自動的にポップアップが閉じます。ポップアップを作成、管理することの詳細はポップアップの記事を見てください。

    拡張機能は1つだけのページアクションを持つ必要があります。

    -

    なお、上に示されている任意のプロパティはpageAction API を使ったコードからも変更できます。

    +

    なお、上に示されている任意のプロパティはpageAction API を使ったコードからも変更できます。

    diff --git a/files/ja/mozilla/add-ons/webextensions/user_interface/popups/index.html b/files/ja/mozilla/add-ons/webextensions/user_interface/popups/index.html index 39fb8332c3..879b2a5e84 100644 --- a/files/ja/mozilla/add-ons/webextensions/user_interface/popups/index.html +++ b/files/ja/mozilla/add-ons/webextensions/user_interface/popups/index.html @@ -15,17 +15,17 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Popups

    -

    ユーザーがボタンをクリックした時、ポップアップが表示されます。ポップアップの外をクリックすると、ポップアップは閉じます。ポップアップは、そこで実行しているスクリプトから window.close() を呼ぶとプログラム的に閉じられます。しかし、拡張機能の JavaScript からプログラム的に開くことはできません。つまりユーザー操作への反応としてだけ開きます。

    +

    ユーザーがボタンをクリックした時、ポップアップが表示されます。ポップアップの外をクリックすると、ポップアップは閉じます。ポップアップは、そこで実行しているスクリプトから window.close() を呼ぶとプログラム的に閉じられます。しかし、拡張機能の JavaScript からプログラム的に開くことはできません。つまりユーザー操作への反応としてだけ開きます。

    "_execute_browser_action""_execute_page_action" ショートカットを使って、ポップアップを開くキーボードショートカットを定義できます。manifest.json の commands キーの文書を見てください。

    ポップアップを指定する

    -

    通常の Web ページと同じく、ポップアップは HTML ファイルで定義されます(ここに CSS や JavaScript も含めることが可能です)。 ただし、拡張機能が持つパーミッションの範囲で JavaScript から WebExtension API にアクセスできる点で通常のものとは異なります。

    +

    通常の Web ページと同じく、ポップアップは HTML ファイルで定義されます(ここに CSS や JavaScript も含めることが可能です)。 ただし、拡張機能が持つパーミッションの範囲で JavaScript から WebExtension API にアクセスできる点で通常のものとは異なります。

    ポップアップの文書はポップアップが表示されるたびに読み込まれて、ポップアップが閉じるたびに開放されます。

    -

    HTML ファイルを拡張機能に入れるには、manifest.json内の browser_actionpage_action キーの "default_popup" にて指定します:

    +

    HTML ファイルを拡張機能に入れるには、manifest.json内の browser_actionpage_action キーの "default_popup" にて指定します:

      "browser_action": {
         "default_icon": "icons/beasts-32.png",
    @@ -33,13 +33,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Popups
         "default_popup": "popup/choose_beast.html"
       }
    -

    ブラウザーの UI と統一感を持たせるスタイルシートをポップアップに組み込めるようになりました。これを利用するためには、browser_actionpage_action キーで "browser_style": true を指定してください。

    +

    ブラウザーの UI と統一感を持たせるスタイルシートをポップアップに組み込めるようになりました。これを利用するためには、browser_actionpage_action キーで "browser_style": true を指定してください。

    -

    ポップアップにおけるリソースの読み込み元や、eval() のように安全でない処理は Content Security Policy によって制限されます。詳細は Content Security Policy を参照してください。

    +

    ポップアップにおけるリソースの読み込み元や、eval() のように安全でない処理は Content Security Policy によって制限されます。詳細は Content Security Policy を参照してください。

    ポップアップのデバッグ

    -

    ポップアップのマークアップと JavaScript をアドオンデバッガーを使ってデバッグできます。しかしポップアップの自動非表示を不可として、ポップアップの外をクリックした時に隠れてしまうのを防ぐ必要があります。ポップアップのデバッグを読んでください

    +

    ポップアップのマークアップと JavaScript をアドオンデバッガーを使ってデバッグできます。しかしポップアップの自動非表示を不可として、ポップアップの外をクリックした時に隠れてしまうのを防ぐ必要があります。ポップアップのデバッグを読んでください

    diff --git a/files/ja/mozilla/add-ons/webextensions/what_are_webextensions/index.html b/files/ja/mozilla/add-ons/webextensions/what_are_webextensions/index.html index 18f9ae7071..398dcf175a 100644 --- a/files/ja/mozilla/add-ons/webextensions/what_are_webextensions/index.html +++ b/files/ja/mozilla/add-ons/webextensions/what_are_webextensions/index.html @@ -16,7 +16,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/What_are_WebExtensions

    例: Amazon Assistant for Firefox, OneNote Web Clipper, Grammarly for Firefox

    -

    ユーザーの個性を見せる: ブラウザー機能拡張はユーザーによってブラウズされるページコンテンツを操作できます。例えば、ユーザーのお気に入りのロゴや写真を、訪れるすべてのページの背景として追加できます。拡張機能は Firefox UI の見た目を更新する力を与えることもできます (スタンドアローンの テーマアドオンを使っても同様に Firefox UI を更新できます)。

    +

    ユーザーの個性を見せる: ブラウザー機能拡張はユーザーによってブラウズされるページコンテンツを操作できます。例えば、ユーザーのお気に入りのロゴや写真を、訪れるすべてのページの背景として追加できます。拡張機能は Firefox UI の見た目を更新する力を与えることもできます (スタンドアローンの テーマアドオンを使っても同様に Firefox UI を更新できます)。

    @@ -28,7 +28,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/What_are_WebExtensions

    例: uBlock Origin, Reader, Toolbox for Google Play Store™

    -

    ツールや新しいブラウズ機能を追加: タスクボードに新しい機能を追加したり、URL やハイパーリンクやページのテキストから QR コード画像を生成したりします。WebExtensions APIs の柔軟な UI オプションや力を得て、ブラウザーに新機能を簡単に追加できます。そしてほぼあらゆるウェブサイトの機能を改良できて、それはあなたのウェブサイトだけとは限りません。

    +

    ツールや新しいブラウズ機能を追加: タスクボードに新しい機能を追加したり、URL やハイパーリンクやページのテキストから QR コード画像を生成したりします。WebExtensions APIs の柔軟な UI オプションや力を得て、ブラウザーに新機能を簡単に追加できます。そしてほぼあらゆるウェブサイトの機能を改良できて、それはあなたのウェブサイトだけとは限りません。

    @@ -44,7 +44,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/What_are_WebExtensions

    例: Web Developer, Web React Developer Tools, aXe Developer Tools

    -

    Firefox 用の拡張機能は WebExtensions APIs を使って作成され、この API はクロスブラウザーで動作可能な拡張機能を開発するための技術です。この API の大半は、Google Chrome や Opera でサポートされている extension API と互換性があります。これらのブラウザー向けに書かれた拡張機能のほとんどは、少し変更を加えるだけで Firefox や Microsoft Edge でも動かせるようになります。この API は完全にマルチプロセス Firefox にも対応しています。

    +

    Firefox 用の拡張機能は WebExtensions APIs を使って作成され、この API はクロスブラウザーで動作可能な拡張機能を開発するための技術です。この API の大半は、Google Chrome や Opera でサポートされている extension API と互換性があります。これらのブラウザー向けに書かれた拡張機能のほとんどは、少し変更を加えるだけで Firefox や Microsoft Edge でも動かせるようになります。この API は完全にマルチプロセス Firefox にも対応しています。

    何かアイデアがあったり、レガシーアドオンを WebExtensions API に移植する手助けが必要な場合、ご連絡は dev-addons メーリングリストAdd-ons roomMatrix までお願いします。英語のサポートです。

    @@ -53,5 +53,5 @@ translation_of: Mozilla/Add-ons/WebExtensions/What_are_WebExtensions diff --git a/files/ja/mozilla/add-ons/webextensions/working_with_files/index.html b/files/ja/mozilla/add-ons/webextensions/working_with_files/index.html index 299643f95c..a3ebf3d90f 100644 --- a/files/ja/mozilla/add-ons/webextensions/working_with_files/index.html +++ b/files/ja/mozilla/add-ons/webextensions/working_with_files/index.html @@ -29,7 +29,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Working_with_files

    ユーザーが saveAs パラメーターで指定した場所にダウンロードさせることもできます。

    -

    Using URL.createObjectURL() you can also download files and blobs defined in your JavaScript, which can include local content retrieved from IndexedDB.

    +

    Using URL.createObjectURL() you can also download files and blobs defined in your JavaScript, which can include local content retrieved from IndexedDB.

    ダウンロード API はダウンロードをキャンセル、停止、再開、消去、削除することもできます; ダウンロードマネージャーでダウンロード済みのファイルを探します; コンピューターのファイルマネージャーでダウンロード済みのファイルを表示します; 関連付けられたアプリケーションでそのファイルを開きます。

    @@ -137,7 +137,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/Working_with_files API References:  idb-file-storage library

    -

    Note: You can also use the full Web IndexedDB API to store data from your extension. This can be useful where you need to store data that isn’t handled well by the simple key/value pairs offered by the DOM Storage API.

    +

    Note: You can also use the full Web IndexedDB API to store data from your extension. This can be useful where you need to store data that isn’t handled well by the simple key/value pairs offered by the DOM Storage API.

    ローカルアプリでファイルを処理する

    @@ -147,14 +147,14 @@ translation_of: Mozilla/Add-ons/WebExtensions/Working_with_files

    You have two options:

      -
    • Connection-based messaging. Here you trigger the process with runtime.connectNative(), which returns a runtime.Port object. You can then pass a JSON message to the native application using the postMessage() function of Port. Using the onMessage.addListener() function of Port you can listen for messages from the native application. The native application is opened if it is not running when runtime.connectNative() is called and the application remains running until the extension calls Port.disconnect() or the page that connected to it is closed.
    • +
    • Connection-based messaging. Here you trigger the process with runtime.connectNative(), which returns a runtime.Port object. You can then pass a JSON message to the native application using the postMessage() function of Port. Using the onMessage.addListener() function of Port you can listen for messages from the native application. The native application is opened if it is not running when runtime.connectNative() is called and the application remains running until the extension calls Port.disconnect() or the page that connected to it is closed.
    • Connectionless messaging. Here you use runtime.sendNativeMessage() to send a JSON message to a new, temporary instance of the native application. The browser closes the native application after receiving any message back from the native application.
    -

    To add the file or blob you want the native application to process use JSON.stringify().

    +

    To add the file or blob you want the native application to process use JSON.stringify().

    -

    To use this method the extension must request the "nativeMessaging" permission in its manifest.json file. Reciprocally, the native application must grant permission for the extension by including its ID in the "allowed_extensions" field of the app manifest.

    +

    To use this method the extension must request the "nativeMessaging" permission in its manifest.json file. Reciprocally, the native application must grant permission for the extension by including its ID in the "allowed_extensions" field of the app manifest.

    Example: Native Messaging (illustrates simple messaging only)
    - Guides: Native messaging
    - API references: runtime API

    + Guides: Native messaging
    + API references: runtime API

    diff --git a/files/ja/mozilla/add-ons/webextensions/your_first_webextension/index.html b/files/ja/mozilla/add-ons/webextensions/your_first_webextension/index.html index 4159864473..55e22732ba 100644 --- a/files/ja/mozilla/add-ons/webextensions/your_first_webextension/index.html +++ b/files/ja/mozilla/add-ons/webextensions/your_first_webextension/index.html @@ -60,7 +60,7 @@ cd borderify
    -

    時折、あなたの拡張機能用に ID を指定する必要があります。アドオンの ID が必要なとき、manifest.json 内に applications キーを入れて gecko.id プロパティをセットします:

    +

    時折、あなたの拡張機能用に ID を指定する必要があります。アドオンの ID が必要なとき、manifest.json 内に applications キーを入れて gecko.id プロパティをセットします:

    "applications": {
       "gecko": {
    @@ -118,7 +118,7 @@ cd borderify

    ここでインストールされたアドオンは Firefox を再起動するまで有効です。

    -

    あるいは、web-ext ツールを使ってコマンドラインから拡張機能を実行することもできます。

    +

    あるいは、web-ext ツールを使ってコマンドラインから拡張機能を実行することもできます。

    テスト

    @@ -140,7 +140,7 @@ cd borderify

    パッケージ化と公開

    -

    自分が作ったアドオンを他の人にも使ってもらうには、アドオンをパッケージとしてまとめた後、署名するために Mozilla へ送信する必要があります。詳細は拡張機能の公開を参照してください。

    +

    自分が作ったアドオンを他の人にも使ってもらうには、アドオンをパッケージとしてまとめた後、署名するために Mozilla へ送信する必要があります。詳細は拡張機能の公開を参照してください。

    次のステップ

    diff --git a/files/ja/mozilla/add-ons/webextensions/your_second_webextension/index.html b/files/ja/mozilla/add-ons/webextensions/your_second_webextension/index.html index 97bf97b2e7..08646b2221 100644 --- a/files/ja/mozilla/add-ons/webextensions/your_second_webextension/index.html +++ b/files/ja/mozilla/add-ons/webextensions/your_second_webextension/index.html @@ -7,14 +7,14 @@ translation_of: Mozilla/Add-ons/WebExtensions/Your_second_WebExtension original_slug: Mozilla/Add-ons/WebExtensions/Walkthrough ---
    {{AddonSidebar}} -

    初めての拡張機能を一通り読んでいる場合、既に拡張機能の書き方を知っていることと思います。この記事では、API の使い方をより詳しく説明するため、前回よりも少し複雑なアドオンを書いてみます。

    +

    初めての拡張機能を一通り読んでいる場合、既に拡張機能の書き方を知っていることと思います。この記事では、API の使い方をより詳しく説明するため、前回よりも少し複雑なアドオンを書いてみます。

    この拡張機能では Firefox のツールバーにボタンを新しく追加します。ユーザーがこのボタンをクリックすると、動物を選択できるポップアップが表示されます。ユーザーが動物を選択すると、ウェブページのコンテンツが選択した動物の画像に置き換わります。

    これらの機能を以下のように実装していきます。

      -
    • ブラウザーアクション (Firefox のツールバーに表示させるボタン)を定義
      +
    • ブラウザーアクション (Firefox のツールバーに表示させるボタン)を定義
      このボタン用に次のものを用意します。
      • "beasts-32.png" というアイコン
      • @@ -88,18 +88,18 @@ cd beastify }
          -
        • 最初の 3 つのキー manifest_versionnameversion は必須であり、拡張機能の基本的なメタデータを指定します
        • -
        • descriptionhomepage_url は省略可能ですが、設定しておくことをお勧めします。これは拡張機能についての役立つ情報となります
        • -
        • icons は省略可能ですが、設定しておくことをお勧めします。この値は拡張機能のアイコンを指定するものであり、アイコンはアドオンマネージャーに表示されます
        • -
        • permissions は拡張機能に必要なパーミッションのリストです。ここでは activeTab パーミッション を要請しています
        • -
        • browser_action はツールバーのボタンを指定するものです。ここでは 3 つの情報を指定しています +
        • 最初の 3 つのキー manifest_versionnameversion は必須であり、拡張機能の基本的なメタデータを指定します
        • +
        • descriptionhomepage_url は省略可能ですが、設定しておくことをお勧めします。これは拡張機能についての役立つ情報となります
        • +
        • icons は省略可能ですが、設定しておくことをお勧めします。この値は拡張機能のアイコンを指定するものであり、アイコンはアドオンマネージャーに表示されます
        • +
        • permissions は拡張機能に必要なパーミッションのリストです。ここでは activeTab パーミッション を要請しています
        • +
        • browser_action はツールバーのボタンを指定するものです。ここでは 3 つの情報を指定しています
          • default_icon ではボタンのアイコンを指定します(必須項目)
          • default_title ではツールチップの文字列を指定します(省略可)
          • default_popup ではユーザーがボタンをクリックした際に表示されるポップアップを指定します。今回はポップアップを表示させたいので、拡張機能に含める HTML ファイルを defualt_popup キーで指定しています
        • -
        • web_accessible_resources はウェブページからアクセスしたいファイルのリストです。この拡張機能では、拡張機能に同梱した画像でウェブページを置き換えるため、画像をウェブページからアクセス可能にする必要があります
        • +
        • web_accessible_resources はウェブページからアクセスしたいファイルのリストです。この拡張機能では、拡張機能に同梱した画像でウェブページを置き換えるため、画像をウェブページからアクセス可能にする必要があります

        パスはすべて manifest.json 自身からの相対パスで指定することに注意します。

        @@ -168,7 +168,7 @@ touch choose_beast.html choose_beast.css choose_beast.js
        </html>
        -

        "popup-content" という ID の <div> 要素があって、動物の選択をする要素が入っています。"error-content" という ID の <div> 要素と "hidden" クラスもあります。それはポップアップの初期化に問題がある場合に使います。

        +

        "popup-content" という ID の <div> 要素があって、動物の選択をする要素が入っています。"error-content" という ID の <div> 要素と "hidden" クラスもあります。それはポップアップの初期化に問題がある場合に使います。

        通常のウェブページと同じように CSS と JS ファイルを読み込んでいることに注意してください。

        @@ -312,9 +312,9 @@ browser.tabs.then(listenForClicks) .catch(reportExecuteScriptError); -

        開始するのは 96行です。ポップアップスクリプトはポップアップが読み込まれ次第、アクティブなタブのコンテンツスクリプトを実行し、その手段は browser.tabs.executeScript() API です。コンテンツスクリプトの実行が成功したら、タブが閉じられるかユーザーが別のページに移動するまで、コンテンツスクリプトがページにロードされたままになります。

        +

        開始するのは 96行です。ポップアップスクリプトはポップアップが読み込まれ次第、アクティブなタブのコンテンツスクリプトを実行し、その手段は browser.tabs.executeScript() API です。コンテンツスクリプトの実行が成功したら、タブが閉じられるかユーザーが別のページに移動するまで、コンテンツスクリプトがページにロードされたままになります。

        -

        browser.tabs.executeScript() の呼び出しがよく失敗する理由は、コンテンツスクリプトをすべてのページでは実行できないことです。例えば、about:debugging のような権限のあるブラウザーページでは実行できませんし、addons.mozilla.org ドメイン内のページでも実行できません。失敗した場合、reportExecuteScriptError()"popup-content" <div> を隠して、"error-content" <div> を表示し、エラーを console にログ出力します。

        +

        browser.tabs.executeScript() の呼び出しがよく失敗する理由は、コンテンツスクリプトをすべてのページでは実行できないことです。例えば、about:debugging のような権限のあるブラウザーページでは実行できませんし、addons.mozilla.org ドメイン内のページでも実行できません。失敗した場合、reportExecuteScriptError()"popup-content" <div> を隠して、"error-content" <div> を表示し、エラーを console にログ出力します。

        コンテンツスクリプトの実行が成功したら、listenForClicks() を呼び出します。これはポップアップのクリックをリッスンします。

        @@ -327,14 +327,14 @@ browser.tabsbrowser.tabs.insertCSS() API -
      • コンテンツスクリプトに "beastify" 送り、その手段は browser.tabs.sendMessage() API。ページを動物化するか尋ねて、動物画像への URL を渡す
      • +
      • CSS を挿入してページの全コンテンツを隠し、その手段は browser.tabs.insertCSS() API
      • +
      • コンテンツスクリプトに "beastify" 送り、その手段は browser.tabs.sendMessage() API。ページを動物化するか尋ねて、動物画像への URL を渡す

      reset() 関数は動物化を取り消す:

        -
      • 追加した CSS を削除し、その手段は browser.tabs.removeCSS() API
      • +
      • 追加した CSS を削除し、その手段は browser.tabs.removeCSS() API
      • コンテンツスクリプトにページをリセットする "reset" メッセージを送る
      @@ -393,10 +393,10 @@ browser.tabsbrowser.runtime.onMessage API です。上で見たように、ポップアップスクリプトは 2種類の異なるメッセージを送ります: "beastify" と "reset"

      +

      その次に、始まる場所は 40行で、ここでコンテンツスクリプトはポップアップからのメッセージをリッスンし、その手段は browser.runtime.onMessage API です。上で見たように、ポップアップスクリプトは 2種類の異なるメッセージを送ります: "beastify" と "reset"

        -
      • メッセージが "beastify" なら、動物画像を指す URL が含まれるはずです。以前の "beastify" 呼び出しで追加された動物をすべて削除して、<img> 要素を作成、追加して、その src 属性に動物の URL をセットします。
      • +
      • メッセージが "beastify" なら、動物画像を指す URL が含まれるはずです。以前の "beastify" 呼び出しで追加された動物をすべて削除して、<img> 要素を作成、追加して、その src 属性に動物の URL をセットします。
      • メッセージが "reset" なら、ただ追加された動物をすべて削除します。
      @@ -445,7 +445,7 @@ browser.tabsコマンドラインから開発する -

      仮インストールを web-ext ツールを用いて自動化できます。次を試してください:

      +

      仮インストールを web-ext ツールを用いて自動化できます。次を試してください:

      cd beastify
       web-ext run
      -- cgit v1.2.3-54-g00ecf