説明
chrome.privacy
API を使用すると、ユーザーのプライバシーに影響する可能性がある Chrome の機能の使用を管理できます。この API は、Chrome の設定を取得して設定するために、タイプ API の ChromeSetting プロトタイプを使用します。
権限
privacy
マニフェスト
API を使用するには、拡張機能のマニフェストで「プライバシー」権限を申告する必要があります。次に例を示します。
{
"name": "My extension",
...
"permissions": [
"privacy"
],
...
}
用途
Chrome の設定の現在の値は簡単に確認できます。まず目的のプロパティを見つけてから、そのオブジェクトの get()
を呼び出して、現在の値と拡張機能の制御レベルを取得します。たとえば、Chrome の自動入力機能が有効になっているかどうかを判断するには、次のように記述します。
chrome.privacy.services.autofillEnabled.get({}, function(details) {
if (details.value) {
console.log('Autofill is on!');
} else {
console.log('Autofill is off!');
}
});
まず、拡張機能が設定を制御できることを確認する必要があるため、設定の値の変更は少し複雑になります。エンタープライズ ポリシーによって特定の値にロックされている設定(levelOfControl
が「not_controllable」に設定)または別の拡張機能で値が制御されている場合(levelOfControl
が「controlled_by_other_extensions」に設定)を拡張機能が切り替えた場合、ユーザーには設定は変更されません。set()
の呼び出しは成功しますが、設定はすぐにオーバーライドされます。混乱を招く可能性があるため、ユーザーが選択した設定が実際に適用されない場合は、ユーザーに警告することをおすすめします。
つまり、get()
メソッドを使用してアクセスレベルを確認し、拡張機能が設定を制御できる場合にのみ set()
を呼び出す必要があります(実際、拡張機能が設定を制御できない場合は、機能を視覚的に無効にしてユーザーの混乱を軽減することをおすすめします)。
chrome.privacy.services.autofillEnabled.get({}, function(details) {
if (details.levelOfControl === 'controllable_by_this_extension') {
chrome.privacy.services.autofillEnabled.set({ value: true }, function() {
if (chrome.runtime.lastError === undefined) {
console.log("Hooray, it worked!");
} else {
console.log("Sadness!", chrome.runtime.lastError);
}
});
}
});
設定値の変更に興味がある場合は、その onChange
イベントにリスナーを追加します。たとえば、最近インストールした拡張機能が設定の制御を取得した場合や、企業ポリシーによって制御がオーバーライドされた場合に、ユーザーに警告できます。たとえば、自動入力のステータスの変更をリッスンするには、次のコードで十分です。
chrome.privacy.services.autofillEnabled.onChange.addListener(
function (details) {
// The new value is stored in `details.value`, the new level of control
// in `details.levelOfControl`, and `details.incognitoSpecific` will be
// `true` if the value is specific to Incognito mode.
}
);
例
この API を試すには、chrome-extension-samples リポジトリからプライバシー API の例をインストールしてください。
型
IPHandlingPolicy
WebRTC の IP 取り扱いポリシー。
Enum
"default"
"default_public_and_private_interfaces"
"default_public_interface_only"
"disable_non_proxied_udp"
プロパティ
network
Chrome によるネットワーク接続全般の処理に影響する設定です。
タイプ
オブジェクト
プロパティ
-
networkPredictionEnabled
types.ChromeSetting<boolean>
有効にすると、Chrome は DNS エントリを事前に解決し、サーバーへの TCP 接続と SSL 接続を予防的に開けることで、ウェブ ブラウジングの高速化を試みます。この設定は、Chrome の内部予測サービスで実行される操作にのみ影響します。ウェブページから開始された事前接続や事前接続には影響しません。この設定の値はブール値で、デフォルトは
true
です。 -
webRTCIPHandlingPolicyChrome 48 以降
WebRTC トラフィックのルーティング方法やローカル アドレス情報の公開量に影響を与えるメディアのパフォーマンスとプライバシーのトレードオフをユーザーが指定できるようにします。この設定の値は IPHandlingPolicy 型で、デフォルトは
default
です。
services
Google とデフォルトの検索プロバイダが提供するサードパーティのネットワーク サービスを必要とする機能を有効または無効にする設定です。
タイプ
オブジェクト
プロパティ
-
alternateErrorPagesEnabled
types.ChromeSetting<boolean>
有効にすると、Chrome はウェブサービスを使用してナビゲーション エラーを解決します。この設定の値はブール値で、デフォルトは
true
です。 -
autofillAddressEnabled
types.ChromeSetting<boolean>
Chrome 70 以降有効にすると、住所やその他のフォームデータを自動入力できるようになります。この設定の値はブール値で、デフォルトは
true
です。 -
autofillCreditCardEnabled
types.ChromeSetting<boolean>
Chrome 70 以降有効にすると、Chrome でクレジット カード フォームに自動入力できます。この設定の値はブール値で、デフォルトは
true
です。 -
autofillEnabled
types.ChromeSetting<boolean>
Chrome 70 以降でサポートが終了privacy.services.autofillAddressEnabled と privacy.services.autofillCreditCardEnabled を使用してください。これは、このリリースでの下位互換性を確保するために残されており、将来削除される予定です。
有効にすると、Chrome でフォームに自動入力できるようになります。この設定の値はブール値で、デフォルトは
true
です。 -
passwordSavingEnabled
types.ChromeSetting<boolean>
有効にすると、パスワードを保存するかどうかを尋ねるメッセージがパスワード マネージャーに表示されます。この設定の値はブール値で、デフォルトは
true
です。 -
safeBrowsingEnabled
types.ChromeSetting<boolean>
有効にすると、Chrome はフィッシングやマルウェアからユーザーを保護するために最善を尽くします。この設定の値はブール値で、デフォルトは
true
です。 -
safeBrowsingExtendedReportingEnabled
types.ChromeSetting<boolean>
有効にすると、セーフ ブラウジングでページがブロックされたときに、ブロックされたページのコンテンツなど、追加情報が Chrome から Google に送信されます。この設定の値はブール値で、デフォルトは
false
です。 -
searchSuggestEnabled
types.ChromeSetting<boolean>
有効にすると、Chrome ではアドレスバーに入力したテキストがデフォルトの検索エンジンに送信されます。検索エンジンでは、これまでに入力した内容に一致するウェブサイトや検索キーワードの候補が表示されます。この設定の値はブール値で、デフォルトは
true
です。 -
spellingServiceEnabled
types.ChromeSetting<boolean>
有効にすると、Chrome はウェブサービスを使用してスペルミスを修正します。この設定の値はブール値で、デフォルトは
false
です。 -
translationServiceEnabled
types.ChromeSetting<boolean>
有効にすると、母国語以外のページの翻訳が表示されます。この設定の値はブール値で、デフォルトは
true
です。
websites
Chrome でウェブサイトで利用できる情報を指定する設定です。
タイプ
オブジェクト
プロパティ
-
adMeasurementEnabled
types.ChromeSetting<boolean>
Chrome 111 以降無効にすると、Attribution Reporting API と Private Aggregation API が無効になります。この設定の値はブール値型で、デフォルト値は
true
です。拡張機能は、値をfalse
に設定することでのみ、これらの API を無効にできます。これらの API をtrue
に設定しようとすると、エラーがスローされます。 -
doNotTrackEnabled
types.ChromeSetting<boolean>
Chrome 65 以降有効にすると、Chrome はリクエストとともに「トラッキング拒否」(
DNT: 1
)ヘッダーを送信します。この設定の値はブール値型で、デフォルト値はfalse
です。 -
fledgeEnabled
types.ChromeSetting<boolean>
Chrome 111 以降無効にすると、Fledge API は無効になります。この設定の値はブール値型で、デフォルト値は
true
です。拡張機能でこの API を無効にするには、値をfalse
に設定します。この API をtrue
に設定しようとすると、エラーがスローされます。 -
hyperlinkAuditingEnabled
types.ChromeSetting<boolean>
有効にすると、ウェブサイト(
<a ping>
)からリクエストされたときに監査 ping が送信されます。この設定の値はブール値型で、デフォルト値はtrue
です。 -
protectedContentEnabled
types.ChromeSetting<boolean>
Windows と ChromeOS でのみ利用可能: 有効にすると、保護されたコンテンツを実行するために、Chrome でプラグインに一意の ID が割り当てられます。この設定の値はブール値型で、デフォルト値は
true
です。 -
referrersEnabled
types.ChromeSetting<boolean>
有効にすると、Chrome はリクエストとともに
referer
ヘッダーを送信します。はい。この設定の名前は、スペルミスのヘッダーと一致しません。いいえ、変更しません。この設定の値はブール値型で、デフォルト値はtrue
です。 -
types.ChromeSetting<boolean>
Chrome 121 以降無効にすると、関連ウェブサイト セットは無効になります。この設定の値はブール値型で、デフォルト値は
true
です。拡張機能でこの API を無効にするには、値をfalse
に設定します。この API をtrue
に設定しようとすると、エラーがスローされます。 -
thirdPartyCookiesAllowed
types.ChromeSetting<boolean>
無効にすると、サードパーティ サイトは Cookie を設定できなくなります。この設定の値はブール値型で、デフォルト値は
true
です。 -
topicsEnabled
types.ChromeSetting<boolean>
Chrome 111 以降無効にすると、Topics API が無効になります。この設定の値はブール値型で、デフォルト値は
true
です。拡張機能でこの API を無効にするには、値をfalse
に設定します。この API をtrue
に設定しようとすると、エラーがスローされます。