API referansı

Çoğu uzantının çalışması için bir veya daha fazla Chrome Extensions API'sine erişmesi gerekir. Bu API referansında, uzantılarda kullanılabilecek API'ler açıklanmakta ve örnek kullanım alanları sunulmaktadır.

accessibilityFeatures

Chrome'un erişilebilirlik özelliklerini yönetmek için chrome.accessibilityFeatures API'yi kullanın. Bu API, bağımsız erişilebilirlik özelliklerini almak ve ayarlamak için API türünün ChromeSetting prototipini kullanır. Özellik durumlarını almak için uzantının accessibilityFeatures.read izni istemesi gerekir. Özellik durumunu değiştirmek için uzantının accessibilityFeatures.modify iznine ihtiyacı var. accessibilityFeatures.modify işlevinin accessibilityFeatures.read iznini ima etmediğini unutmayın.

alarmlar

Kodu düzenli aralıklarla veya gelecekte belirli bir zamanda çalışacak şekilde planlamak için chrome.alarms API'yi kullanın.

ses
Chrome 59 ve sonraki sürümler Yalnızca ChromeOS

chrome.audio API, kullanıcıların sisteme bağlı ses cihazları hakkında bilgi edinmelerine ve bu cihazları kontrol etmelerine olanak tanımak için sağlanmaktadır. Bu API şu anda yalnızca ChromeOS için kiosk modunda kullanılabilir.

yer işaretleri

Yer işaretlerini oluşturmak, düzenlemek ve diğer amaçlarla değiştirmek için chrome.bookmarks API'sini kullanın. Ayrıca, özel bir Yer İşareti Yöneticisi sayfası oluşturmak için kullanabileceğiniz Sayfaları Geçersiz Kılma konusuna da bakın.

browserAction
≤ MV2

Tarayıcı işlemlerini kullanarak simgeleri ana Google Chrome araç çubuğuna, adres çubuğunun sağına yerleştirin. Bir tarayıcı işlemi, simgesine ek olarak bir ipucu, rozet ve pop-up içerebilir.

browsingData

Bir kullanıcının yerel profilindeki tarama verilerini kaldırmak için chrome.browsingData API'yi kullanın.

certificateProvider
Chrome 46 ve sonraki sürümler Yalnızca ChromeOS

Sertifikaları, TLS kimlik doğrulamaları için bu sertifikaları kullanabilen platformda kullanıma sunmak için bu API'yi kullanın.

komutlar

Uzantınızda işlemleri (ör. tarayıcı işlemini açma işlemi veya uzantıya komut gönderme) tetikleyen klavye kısayolları eklemek için Command API'yi kullanın.

contentSettings

Web sitelerinin çerezler, JavaScript ve eklentiler gibi özellikleri kullanıp kullanamayacağını kontrol eden ayarları değiştirmek için chrome.contentSettings API'sini kullanın. Daha genel bir ifadeyle, içerik ayarları Chrome'un davranışını genel olarak değil, site bazında özelleştirmenize olanak tanır.

contextMenus

Google Chrome'un içerik menüsüne öğe eklemek için chrome.contextMenus API'sini kullanın. İçerik menüsüne eklediğiniz öğelerin resim, köprü ve sayfa gibi nesne türlerini seçebilirsiniz.

çerez

Çerezleri sorgulamak, değiştirmek ve değişiklik yapıldığında bildirim almak için chrome.cookies API'yi kullanın.

debugger

chrome.debugger API'si, Chrome'un uzaktan hata ayıklama protokolü için alternatif bir aktarım görevi görür. Ağ etkileşimi aracı üzerinden bir veya daha fazla sekme eklemek, JavaScript'te hata ayıklamak, DOM ve CSS'yi değiştirmek ve daha pek çok işlem için chrome.debugger kullanın. sendCommand içeren sekmeleri hedeflemek ve etkinlikleri onEvent geri çağırmalarından tabId tarihine göre yönlendirmek için Debuggee özelliğini tabId kullanın.

declarativeContent

Sayfanın içeriğini okuma izni gerekmeden, sayfanın içeriğine göre işlem yapmak için chrome.declarativeContent API'sini kullanın.

declarativeNetRequest
Chrome 84 ve sonraki sürümler

chrome.declarativeNetRequest API, bildirim temelli kurallar belirleyerek ağ isteklerini engellemek veya değiştirmek için kullanılır. Bu sayede uzantılar, ağ isteklerini müdahale etmeden ve içeriklerini görüntülemeden değiştirerek daha fazla gizlilik sağlar.

declarativeWebRequest
Beta kanalı ≤ MV2

Not: Bu API'nin desteği sonlandırılmıştır. Bunun yerine declarativeNetRequest API'yi inceleyin. Yayındaki isteklere müdahale etmek, bunları engellemek veya değiştirmek için chrome.declarativeWebRequest API'yi kullanın. chrome.webRequest API'den önemli ölçüde daha hızlıdır çünkü JavaScript motoru yerine tarayıcıda değerlendirilen kuralları kaydedebilirsiniz. Böylece, gidiş dönüş gecikmelerini azaltıp daha yüksek verimlilik elde edebilirsiniz.

desktopCapture

Desktop Capture API ekranın içeriğini, tek tek pencereleri veya tek tek sekmeleri yakalar.

devtools.inspectedWindow

İncelenen pencereyle etkileşim kurmak için chrome.devtools.inspectedWindow API'sini kullanın: İncelenen sayfanın sekme kimliğini alın, kodu denetlenen pencere bağlamında değerlendirin, sayfayı yeniden yükleyin veya sayfadaki kaynakların listesini alın.

devtools.network

Geliştirici Araçları tarafından Ağ panelinde görüntülenen ağ istekleriyle ilgili bilgileri almak için chrome.devtools.network API'sini kullanın.

devtools.panels

Uzantınızı Geliştirici Araçları pencere kullanıcı arayüzüne entegre etmek için chrome.devtools.panels API'sini kullanın: Kendi panellerinizi oluşturun, mevcut panellere erişin ve kenar çubukları ekleyin.

devtools.recorder
Chrome 105 ve sonraki sürümler

Geliştirici Araçları'ndaki Kaydedici panelini özelleştirmek için chrome.devtools.recorder API'yi kullanın.

dns
Yeni geliştirilenler kanalı

DNS çözünürlüğü için chrome.dns API'yi kullanın.

documentScan
Chrome 44 ve sonraki sürümler Yalnızca ChromeOS

Ekli belge tarayıcılardan resim keşfetmek ve almak için chrome.documentScan API'yi kullanın.

dom
Chrome 88 ve sonraki sürümler

Uzantılar için özel DOM API'lerine erişmek üzere chrome.dom API'yi kullanın

indirme sayısı

İndirme işlemlerini programatik olarak başlatmak, izlemek, işlemek ve aramak için chrome.downloads API'yi kullanın.

enterprise.deviceAttributes
Chrome 46 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Cihaz özelliklerini okumak için chrome.enterprise.deviceAttributes API'yi kullanın. Not: Bu API yalnızca kurumsal politika tarafından zorunlu olarak yüklenmiş uzantılar için kullanılabilir.

enterprise.hardwarePlatform
Chrome 71 ve sonraki sürümler Politika gerektirir

Tarayıcının çalıştığı donanım platformunun üreticisini ve modelini almak için chrome.enterprise.hardwarePlatform API'yi kullanın. Not: Bu API yalnızca kurumsal politikaya göre yüklenen uzantılar tarafından kullanılabilir.

enterprise.networkingAttributes
Chrome 85 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Mevcut ağınızla ilgili bilgileri okumak için chrome.enterprise.networkingAttributes API'yi kullanın. Not: Bu API yalnızca kurumsal politika tarafından zorunlu olarak yüklenmiş uzantılar için kullanılabilir.

enterprise.platformKeys
Yalnızca ChromeOS Politika gerektirir

chrome.enterprise.platformKeys API'yi kullanarak bu anahtarlar için anahtar oluşturun ve sertifikaları yükleyin. Sertifikalar platform tarafından yönetilir ve TLS kimlik doğrulaması, ağ erişimi veya chrome.platformKeys aracılığıyla başka bir uzantı tarafından kullanılabilir.

etkinlikler

chrome.events ad alanı, ilginç bir şey olduğunda sizi bilgilendirmek için etkinlik gönderen API'lerin kullandığı yaygın türleri içerir.

uzantı

chrome.extension API, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar içerir. Bu araç, İleti Aktarma bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile onun içerik komut dosyaları veya uzantılar arasında mesaj alışverişinde bulunma desteği içerir.

extensionTypes

chrome.extensionTypes API, Chrome uzantıları için tür bildirimleri içerir.

fileBrowserHandler
Yalnızca ChromeOS Yalnızca ön plan

Chrome OS dosya tarayıcısını genişletmek için chrome.fileBrowserHandler API'yi kullanın. Örneğin, kullanıcıların web sitenize dosya yükleyebilmesini sağlamak için bu API'yi kullanabilirsiniz.

fileSystemProvider
Yalnızca ChromeOS

Chrome OS'teki dosya yöneticisinden erişilebilen dosya sistemleri oluşturmak için chrome.fileSystemProvider API'sini kullanın.

fontSettings

Chrome'un yazı tipi ayarlarını yönetmek için chrome.fontSettings API'yi kullanın.

gcm

Uygulamaları ve uzantıları Firebase Cloud Messaging (FCM) üzerinden mesaj gönderip alacak şekilde etkinleştirmek için chrome.gcm kullanın.

geçmiş

Tarayıcının ziyaret edilen sayfalarıyla ilgili kaydıyla etkileşimde bulunmak için chrome.history API'yi kullanın. Tarayıcının geçmişindeki URL'leri ekleyebilir, kaldırabilir ve sorgulayabilirsiniz. Geçmiş sayfasını kendi sürümünüzle geçersiz kılmak için Sayfaları Geçersiz Kılma konusuna bakın.

i18n

Uygulamanızın veya uzantınızın tamamında uluslararasılaştırma sağlamak için chrome.i18n altyapısını kullanın.

kimlik

OAuth2 erişim jetonları almak için chrome.identity API'yi kullanın.

boşta

Makinenin boşta kalma durumunun ne zaman değiştiğini algılamak için chrome.idle API'yi kullanın.

input.ime
Yalnızca ChromeOS

Chrome OS için özel bir IME uygulamak üzere chrome.input.ime API'yi kullanın. Bu, uzantınızın tuş vuruşlarını işlemesine, besteyi ayarlamasına ve aday pencereyi yönetmesine olanak tanır.

instanceID
Chrome 44 ve sonraki sürümler

Örnek Kimliği hizmetine erişmek için chrome.instanceID kullanın.

loginState
Chrome 78 ve sonraki sürümler Yalnızca ChromeOS

Giriş durumunu okumak ve izlemek için chrome.loginState API'yi kullanın.

yönetimi

chrome.management API, yüklü ve çalışan uzantıların/uygulamaların listesini yönetmenin yollarını sağlar. Özellikle yerleşik Yeni Sekme sayfasını geçersiz kılan uzantılar için yararlıdır.

bildirimler

Şablonları kullanarak zengin bildirimler oluşturmak ve bu bildirimleri sistem tepsisinde kullanıcılara göstermek için chrome.notifications API'sını kullanın.

çok amaçlı adres çubuğu

Çok amaçlı adres çubuğu API'sı, çok amaçlı adres çubuğu olarak da bilinen Google Chrome'un adres çubuğuna anahtar kelimeleri kaydetmenize olanak tanır.

pageAction
≤ MV2

Google Chrome ana araç çubuğunda, adres çubuğunun sağ tarafındaki simgeleri yerleştirmek için chrome.pageAction API'sini kullanın. Sayfa işlemleri, geçerli sayfada gerçekleştirilebilecek ancak tüm sayfalar için geçerli olmayan işlemleri temsil eder. Sayfa işlemleri etkin değilken devre dışı görünür.

pageCapture

Bir sekmeyi MHTML olarak kaydetmek için chrome.pageCapture API'sini kullanın.

izinler

Beyan edilen isteğe bağlı izinleri yükleme anında değil, çalışma zamanında istemek için chrome.permissions API'yi kullanın. Böylece, kullanıcılar izinlerin neden gerekli olduğunu anlar ve yalnızca gerekli izinleri verir.

platformKeys
Chrome 45 ve sonraki sürümler Yalnızca ChromeOS

Platform tarafından yönetilen istemci sertifikalarına erişmek için chrome.platformKeys API'yi kullanın. Kullanıcı veya politika izin verirse bir uzantı, özel kimlik doğrulama protokolünde böyle bir sertifikayı kullanabilir. Örneğin bu, platform tarafından yönetilen sertifikaların üçüncü taraf VPN'lerde kullanılmasına izin verir (chrome.vpnProvider'a bakın).

güç

Sistemin güç yönetimi özelliklerini geçersiz kılmak için chrome.power API'yi kullanın.

printerProvider
Chrome 44 ve sonraki sürümler

chrome.printerProvider API, yazdırma yöneticisi tarafından kullanılan etkinlikleri, uzantılar tarafından kontrol edilen yazıcıları sorgulamak, özelliklerini sorgulamak ve yazdırma işlerini bu yazıcılara göndermek için kullanıma sunar.

yazdırma
Chrome 81 ve sonraki sürümler Yalnızca ChromeOS

Yazdırma işlerini Chromebook'ta yüklü yazıcılara göndermek için chrome.printing API'yi kullanın.

printingMetrics
Chrome 79 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Yazdırma kullanımıyla ilgili verileri getirmek için chrome.printingMetrics API'yi kullanın.

gizlilik

Chrome'da kullanıcı gizliliğini etkileyebilecek özelliklerin kullanımını kontrol etmek için chrome.privacy API'yi kullanın. Bu API, Chrome'un yapılandırmasını almak ve ayarlamak için API türünün ChromeSetting prototipini kullanır.

işlemler
Yeni geliştirilenler kanalı

Tarayıcı işlemleriyle etkileşimde bulunmak için chrome.processes API'yi kullanın.

proxy

Chrome'un proxy ayarlarını yönetmek için chrome.proxy API'yi kullanın. Bu API, proxy yapılandırmasını almak ve ayarlamak için API türünün ChromeSetting prototipini kullanır.

çalışma zamanı

Hizmet çalışanını almak, manifest ile ilgili ayrıntıları döndürmek ve uzantı yaşam döngüsündeki etkinlikleri dinlemek ve bunlara yanıt vermek için chrome.runtime API'yi kullanın. Bu API'yi, URL'lerin göreli yolunu tam nitelikli URL'lere dönüştürmek için de kullanabilirsiniz.

search
Chrome 87 ve sonraki sürümler

Varsayılan sağlayıcı üzerinden arama yapmak için chrome.search API'yi kullanın.

oturumlar

Bir tarama oturumundaki sekmeleri ve pencereleri sorgulamak ve geri yüklemek için chrome.sessions API'yi kullanın.

depolama alanı

Kullanıcı verilerini depolamak, almak ve izlemek için chrome.storage API'yi kullanın.

system.cpu

CPU meta verilerini sorgulamak için system.cpu API'yi kullanın.

system.display

Ekran meta verilerini sorgulamak için system.display API'sini kullanın.

system.memory

chrome.system.memory API.

system.storage

Depolama cihazı bilgilerini sorgulamak ve çıkarılabilir depolama cihazı takılıp çıkarıldığında bildirim almak için chrome.system.storage API'yi kullanın.

systemLog
Chrome 125 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Uzantılardan Chrome sistem günlüklerini kaydetmek için chrome.systemLog API'yi kullanın.

tabCapture

Sekme medya akışlarıyla etkileşimde bulunmak için chrome.tabCapture API'sini kullanın.

sekmeler

Tarayıcının sekme sistemiyle etkileşimde bulunmak için chrome.tabs API'yi kullanın. Bu API'yi tarayıcıda sekmeler oluşturmak, değiştirmek ve yeniden düzenlemek için kullanabilirsiniz.

topSites

Yeni sekme sayfasında görüntülenen en popüler sitelere (yani en çok ziyaret edilen siteler) erişmek için chrome.topSites API'yi kullanın. Bunlar, kullanıcı tarafından özelleştirilmiş kısayolları içermez.

tts

Sentezlenmiş metin okuma (TTS) çalmak için chrome.tts API'yi kullanın. Ayrıca, uzantıların konuşma motoru uygulamasına izin veren ilgili ttsEngine API'sine de bakın.

ttsEngine

Bir uzantı kullanarak metin okuma(TTS) motoru uygulamak için chrome.ttsEngine API'yi kullanın. Uzantınız bu API'yi kullanarak kaydoluyorsa, herhangi bir uzantı veya Chrome uygulaması konuşma oluşturmak için tts API'yi kullandığında, söylenecek bir sözü ve diğer parametreleri içeren etkinlikler alır. Böylece uzantınız konuşmayı sentezlemek ve çıktısını almak için mevcut herhangi bir web teknolojisini kullanabilir ve durumu bildirmek için etkinlikleri çağrı işlevine geri gönderebilir.

türler

chrome.types API, Chrome için tür bildirimleri içerir.

vpnProvider
Chrome 43 ve sonraki sürümler Yalnızca ChromeOS

Bir VPN istemcisini uygulamak için chrome.vpnProvider API'yi kullanın.

duvar kağıdı
Chrome 43 ve sonraki sürümler Yalnızca ChromeOS

ChromeOS duvar kağıdını değiştirmek için chrome.wallpaper API'yi kullanın.

webNavigation

Yayındaki navigasyon isteklerinin durumu hakkında bildirim almak için chrome.webNavigation API'yi kullanın.

webRequest

Trafiği gözlemleyip analiz etmek, yayındaki isteklere müdahale etmek, bunları engellemek veya değiştirmek için chrome.webRequest API'yi kullanın.

pencereler

Tarayıcı pencereleriyle etkileşimde bulunmak için chrome.windows API'yi kullanın. Tarayıcıda pencereler oluşturmak, değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz.