Deskripsi
Gunakan chrome.privacy
API untuk mengontrol penggunaan fitur di Chrome yang dapat memengaruhi privasi pengguna. API ini bergantung pada prototipe ChromeSetting dari jenis API untuk mendapatkan dan menyetel konfigurasi Chrome.
Izin
privacy
Anda harus menyatakan izin "privasi" dalam manifes ekstensi Anda untuk menggunakan API. Contoh:
{
"name": "My extension",
...
"permissions": [
"privacy"
],
...
}
Konsep dan penggunaan
Anda dapat membaca nilai setelan Chrome saat ini dengan mudah. Pertama-tama, Anda harus menemukan properti yang diinginkan, lalu memanggil get()
pada objek tersebut untuk mengambil nilainya saat ini dan tingkat kontrol ekstensi Anda. Misalnya, untuk menentukan apakah fitur isi otomatis kartu kredit
Chrome diaktifkan, tulis:
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.value) {
console.log('Autofill is on!');
} else {
console.log('Autofill is off!');
}
});
Mengubah nilai setelan sedikit lebih rumit, karena Anda harus terlebih dahulu memverifikasi bahwa ekstensi Anda dapat mengontrol setelan tersebut. Pengguna tidak akan melihat perubahan apa pun pada setelannya jika ekstensi Anda mengalihkan setelan yang dikunci ke nilai tertentu oleh kebijakan perusahaan (levelOfControl
akan ditetapkan ke "not_controllable"), atau jika ekstensi lain mengontrol nilai tersebut (levelOfControl
akan ditetapkan ke "controlled_by_other_extensions"). Panggilan set()
akan
berhasil, tetapi setelan akan segera diganti. Karena hal ini mungkin membingungkan, sebaiknya
peringatkan pengguna saat setelan yang mereka pilih tidak praktis diterapkan.
Ini berarti Anda harus menggunakan metode get()
untuk menentukan tingkat akses, lalu hanya memanggil set()
jika ekstensi Anda dapat mengambil kontrol atas setelan (bahkan jika ekstensi Anda tidak dapat mengontrol setelan, sebaiknya nonaktifkan fitur secara visual untuk mengurangi kebingungan pengguna):
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.levelOfControl === 'controllable_by_this_extension') {
chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
if (chrome.runtime.lastError === undefined) {
console.log("Hooray, it worked!");
} else {
console.log("Sadness!", chrome.runtime.lastError);
}
});
}
});
Jika Anda ingin mengubah nilai setelan, tambahkan pemroses ke peristiwa onChange
-nya. Di antara penggunaan lainnya, hal ini memungkinkan Anda memperingatkan pengguna jika ekstensi yang baru diinstal mengambil kontrol atas suatu setelan, atau jika kebijakan perusahaan menggantikan kontrol Anda. Misalnya, untuk memproses perubahan pada
status isi otomatis kartu kredit, kode berikut ini sudah cukup:
chrome.privacy.services.autofillCreditCardEnabled.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.
}
);
Contoh
Untuk mencoba API ini, instal contoh privacy API dari repositori chrome-extension-samples.
Jenis
IPHandlingPolicy
Kebijakan penanganan IP WebRTC.
Enum
"default"
"default_public_and_private_interfaces"
"default_public_interface_only"
"disable_non_proxied_udp"
Properti
network
Setelan yang memengaruhi penanganan koneksi jaringan Chrome secara umum.
Jenis
objek
Properti
-
networkPredictionEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan mencoba mempercepat pengalaman penjelajahan web Anda dengan menyelesaikan sebelumnya entri DNS dan membuka koneksi TCP dan SSL ke server secara preemptive. Preferensi ini hanya memengaruhi tindakan yang dilakukan oleh layanan prediksi internal Chrome. Hal ini tidak memengaruhi prefek atau prakoneksi yang dimulai halaman web. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
webRTCIPHandlingPolicyChrome 48+
Izinkan pengguna menentukan keseimbangan antara performa/privasi media yang memengaruhi cara pemilihan rute traffic WebRTC dan seberapa banyak informasi alamat lokal yang terekspos. Nilai preferensi ini adalah jenis IPHandlingPolicy, yang secara default disetel ke
default
.
services
Setelan yang mengaktifkan atau menonaktifkan fitur yang memerlukan layanan jaringan pihak ketiga yang disediakan oleh Google dan penyedia penelusuran default Anda.
Jenis
objek
Properti
-
alternateErrorPagesEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan menggunakan layanan web untuk membantu mengatasi error navigasi. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
autofillAddressEnabled
types.ChromeSetting<boolean>
Chrome 70 dan yang lebih baruJika diaktifkan, Chrome akan menawarkan untuk otomatis mengisi alamat dan data formulir lainnya. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
autofillCreditCardEnabled
types.ChromeSetting<boolean>
Chrome 70 dan yang lebih baruJika diaktifkan, Chrome akan menawarkan untuk mengisi formulir kartu kredit secara otomatis. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
autofillEnabled
types.ChromeSetting<boolean>
Tidak digunakan lagi sejak Chrome 70Gunakan privacy.services.autofillAddressEnabled dan privacy.services.autofillCreditCardEnabled. Hal ini tetap untuk kompatibilitas mundur dalam rilis ini dan akan dihapus pada masa mendatang.
Jika diaktifkan, Chrome akan menawarkan untuk mengisi formulir secara otomatis. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
passwordSavingEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, pengelola sandi akan menanyakan apakah Anda ingin menyimpan sandi. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
safeBrowsingEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan berupaya sebaik mungkin untuk melindungi Anda dari phishing dan malware. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
safeBrowsingExtendedReportingEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan mengirimkan informasi tambahan ke Google saat SafeBrowsing memblokir halaman, seperti konten halaman yang diblokir. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
false
. -
searchSuggestEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan mengirimkan teks yang Anda ketik ke Omnibox ke mesin telusur default Anda, yang memberikan prediksi situs dan penelusuran yang kemungkinan merupakan penyelesaian dari yang telah Anda ketik sejauh ini. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
. -
spellingServiceEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan menggunakan layanan web untuk membantu memperbaiki kesalahan ejaan. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
false
. -
translationServiceEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan menawarkan untuk menerjemahkan halaman yang tidak dalam bahasa yang Anda baca. Nilai preferensi ini adalah boolean, yang ditetapkan secara default ke
true
.
websites
Setelan yang menentukan informasi yang disediakan Chrome untuk situs.
Jenis
objek
Properti
-
adMeasurementEnabled
types.ChromeSetting<boolean>
Chrome 111 dan yang lebih baruJika dinonaktifkan, Attribution Reporting API dan Private Aggregation API akan dinonaktifkan. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalah
true
. Ekstensi hanya dapat menonaktifkan API ini dengan menetapkan nilai kefalse
. Jika Anda mencoba menyetel API ini ketrue
, error akan muncul. -
doNotTrackEnabled
types.ChromeSetting<boolean>
Chrome 65 dan yang lebih baruJika diaktifkan, Chrome akan mengirimkan header 'Jangan Lacak' (
DNT: 1
) bersama permintaan Anda. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalahfalse
. -
fledgeEnabled
types.ChromeSetting<boolean>
Chrome 111 dan yang lebih baruJika dinonaktifkan, Fledge API akan dinonaktifkan. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalah
true
. Ekstensi hanya dapat menonaktifkan API ini dengan menetapkan nilai kefalse
. Jika Anda mencoba menyetel API ini ketrue
, error akan muncul. -
hyperlinkAuditingEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan mengirim ping audit saat diminta oleh situs (
<a ping>
). Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalahtrue
. -
protectedContentEnabled
types.ChromeSetting<boolean>
Hanya tersedia di Windows dan ChromeOS: Jika diaktifkan, Chrome akan memberikan ID unik ke plugin untuk menjalankan konten yang dilindungi. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalah
true
. -
referrersEnabled
types.ChromeSetting<boolean>
Jika diaktifkan, Chrome akan mengirimkan header
referer
bersama permintaan Anda. Ya, nama preferensi ini tidak cocok dengan header yang salah eja. Tidak, kami tidak akan mengubahnya. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalahtrue
. -
types.ChromeSetting<boolean>
Chrome 121 dan yang lebih baruJika dinonaktifkan, Set Situs Terkait akan dinonaktifkan. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalah
true
. Ekstensi hanya dapat menonaktifkan API ini dengan menetapkan nilai kefalse
. Jika Anda mencoba menyetel API ini ketrue
, error akan muncul. -
thirdPartyCookiesAllowed
types.ChromeSetting<boolean>
Jika dinonaktifkan, Chrome akan memblokir situs pihak ketiga agar tidak menyetel cookie. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalah
true
. -
topicsEnabled
types.ChromeSetting<boolean>
Chrome 111 dan yang lebih baruJika dinonaktifkan, Topics API akan dinonaktifkan. Nilai preferensi ini adalah jenis boolean, dan nilai defaultnya adalah
true
. Ekstensi hanya dapat menonaktifkan API ini dengan menetapkan nilai kefalse
. Jika Anda mencoba menyetel API ini ketrue
, error akan muncul.