API referansı

Çoğu uzantının çalışması için bir veya daha fazla Chrome uzantısı API'sine erişmesi gerekir. Bu API referansında, uzantılarda kullanılabilen 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, erişilebilirlik özelliklerini tek tek almak ve ayarlamak için API türündeki ChromeSetting prototipinden yararlanır. Uzantının özellik durumlarını alabilmesi için accessibilityFeatures.read iznini istemesi gerekir. Uzantının, özellik durumunu değiştirmek için accessibilityFeatures.modify iznine ihtiyacı vardır. accessibilityFeatures.modify, accessibilityFeatures.read izni anlamına gelmez.

alarms

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

audio
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 edinmesine ve bu cihazları kontrol etmesine olanak tanımak için sağlanır. Bu API şu anda yalnızca ChromeOS için kiosk modunda kullanılabilir.

yer işaretleri

Yer işaretleri oluşturmak, düzenlemek ve başka şekilde işlemek için chrome.bookmarks API'yi kullanın. Özel bir yer işareti yöneticisi sayfası oluşturmak için kullanabileceğiniz Sayfaları geçersiz kılma başlıklı makaleyi de inceleyin.

browserAction
≤ MV2

Adres çubuğunun sağındaki ana Google Chrome araç çubuğuna simge yerleştirmek için tarayıcı işlemlerini kullanın. Tarayıcı işlemlerinin simgesine ek olarak ipucu, rozet ve pop-up olabilir.

browsingData

Kullanıcının yerel profilinden göz atma verilerini kaldırmak için chrome.browsingData API'yi kullanın.

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

Bu API'yi kullanarak sertifikalarınızı platforma gösterin. Platform, bu sertifikaları TLS kimlik doğrulamaları için kullanabilir.

komutlar

Uzantınızda işlemleri tetikleyen klavye kısayolları (ör. tarayıcı eylemini açan veya uzantıya komut gönderen bir işlem) eklemek için komutlar API'sini kullanın.

contentSettings

Web sitelerinin çerezler, JavaScript ve eklentiler gibi özellikleri kullanıp kullanamayacaklarını kontrol eden ayarları değiştirmek için chrome.contentSettings API'yi 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 bağlam menüsüne öğe eklemek için chrome.contextMenus API'yi kullanın. İçerik menüsü eklemelerinizin resim, köprü ve sayfa gibi nesne türleri için geçerli olup olmayacağını seçebilirsiniz.

cookies

Çerezleri sorgulamak ve değiştirmek ve değiştiklerinde bildirim almak için chrome.cookies API'yi kullanın.

hata ayıklayıcı

chrome.debugger API, Chrome'un uzak hata ayıklama protokolü için alternatif bir aktarım aracı olarak kullanılır. Ağ etkileşimini ölçmek, JavaScript'de hata ayıklama yapmak, DOM ve CSS'yi değiştirmek ve daha fazlası için bir veya daha fazla sekmeye eklemek üzere chrome.debugger simgesini kullanın. Sekmeleri sendCommand ile hedeflemek ve etkinlikleri onEvent geri çağırmalarından tabId'a göre yönlendirmek için Debuggee tabId mülkünü kullanın.

declarativeContent

Sayfanın içeriğini okuma izni gerekmeden sayfanın içeriğine bağlı işlemler yapmak için chrome.declarativeContent API'yi kullanın.

declarativeNetRequest
Chrome 84 ve üzeri sürümler

chrome.declarativeNetRequest API, açıklayıcı kurallar belirterek ağ isteklerini engellemek veya değiştirmek için kullanılır. Bu sayede uzantılar, ağ isteklerini araya girmeden ve içeriklerini görüntülemeden değiştirebilir. Böylece daha fazla gizlilik sağlanır.

declarativeWebRequest
Beta kanalı ≤ MV2

Not: Bu API'nin desteği sonlandırılmıştır. Bunun yerine declarativeNetRequest API'sine göz atın. Gönderilen istekleri durdurmak, engellemek veya değiştirmek için chrome.declarativeWebRequest API'yi kullanın. JavaScript motoru yerine tarayıcıda değerlendirilen kuralları kaydedebildiğiniz için chrome.webRequest API'den önemli ölçüde daha hızlıdır. Bu da gidiş dönüş gecikmelerini azaltır ve daha yüksek verimlilik sağlar.

desktopCapture

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

devtools.inspectedWindow

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

devtools.network

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

devtools.panels

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

devtools.performance
Chrome 129 ve üzeri sürümler

Geliştirici Araçları'ndaki Performans panelinde kayıt durumu güncellemelerini dinlemek için chrome.devtools.performance API'yi kullanın.

devtools.recorder
Chrome 105 ve üzeri 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ümü için chrome.dns API'yi kullanın.

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

Ekli doküman tarayıcılardan görüntü bulmak 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 kullanma

downloads

İndirmeleri programatik olarak başlatmak, izlemek, değiştirmek 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'yi yalnızca kurumsal politika tarafından zorunlu olarak yüklenen uzantılar kullanabilir.

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'yi yalnızca kurumsal politika tarafından yüklenen uzantılar kullanabilir.

enterprise.login
Beklemede Yalnızca ChromeOS Politika gerektirir

Yönetilen misafir oturumlarından çıkmak için chrome.enterprise.login API'yi kullanın. Not: Bu API'yi yalnızca ChromeOS Yönetilen Misafir oturumlarında kurumsal politika tarafından yüklenen uzantılar kullanabilir.

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'yi yalnızca kurumsal politika tarafından zorunlu olarak yüklenen uzantılar kullanabilir.

enterprise.platformKeys
Yalnızca ChromeOS Politika gerektirir

Anahtar oluşturmak ve bu anahtarlara sertifika yüklemek için chrome.enterprise.platformKeys API'yi kullanın. Sertifikalar platform tarafından yönetilir ve TLS kimlik doğrulaması, ağ erişimi veya chrome.platformKeys aracılığıyla diğer uzantılar tarafından kullanılabilir.

etkinlikler

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

extension

chrome.extension API'sinde, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar bulunur. Mesaj Geçişi bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile içeriği komut dosyaları veya uzantılar arasında mesaj alışverişi için destek içerir.

extensionTypes

chrome.extensionTypes API, Chrome uzantılarıyla ilgili tür tanımlarını 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üklemesine izin vermek için bu API'yi kullanabilirsiniz.

fileSystemProvider
Yalnızca ChromeOS

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

fontSettings

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

gcm

Uygulamaların ve uzantıların Firebase Cloud Messaging (FCM) üzerinden mesaj gönderip almasını sağlamak için chrome.gcm simgesini kullanın.

history

Tarayıcıda ziyaret edilen sayfaların kaydıyla etkileşimde bulunmak için chrome.history API'yi kullanın. Tarayıcı geçmişine URL ekleyebilir, mevcut URL'leri kaldırabilir ve URL'leri sorgulayabilirsiniz. Geçmiş sayfasını kendi sürümünüzle geçersiz kılmak için Sayfaları geçersiz kılma başlıklı makaleyi inceleyin.

i18n

Uygulamanızın veya uzantınızın tamamında uluslararasılaştırmayı uygulamak için chrome.i18n altyapısını kullanın.

identity

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

idle

Makinenin boş durumdaki 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 sayede uzantınız tuş vuruşlarını işleyebilir, kompozisyonu ayarlayabilir ve aday penceresini yönetebilir.

instanceID
Chrome 44 ve üzeri 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ü uygulamaları ve uzantıları yönetmenin yollarını sağlar.

notifications

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

omnibox

Her şey bir arada kutusu API'si, bir anahtar kelimeyi Google Chrome'un her şey bir arada kutusu olarak da bilinen adres çubuğuna kaydetmenize olanak tanır.

pageAction
≤ MV2

Adres çubuğunun sağındaki ana Google Chrome araç çubuğuna simge yerleştirmek için chrome.pageAction API'yi kullanın. Sayfa işlemleri, geçerli sayfada yapılabilen ancak tüm sayfalar için geçerli olmayan işlemleri temsil eder. Sayfa işlemleri etkin olmadığında devre dışı görünür.

pageCapture

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

permissions

Beyan edilen isteğe bağlı izinleri yükleme zamanından ziyade çalışma zamanında istemek için chrome.permissions API'yi kullanın. Böylece kullanıcılar izinlerin neden gerekli olduğunu anlayıp yalnızca gerekli olanları verir.

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

Platform tarafından yönetilen istemci sertifikalarına erişmek için chrome.platformKeys API'sini kullanın. Kullanıcı veya politika izin verirse uzantı, özel kimlik doğrulama protokolünde bu tür bir sertifika kullanabilir. Örneğin, bu ayar üçüncü taraf VPN'lerde platform tarafından yönetilen sertifikaların kullanılmasına olanak tanır (chrome.vpnProvider bölümüne bakın).

power

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

printerProvider
Chrome 44 ve üzeri sürümler

chrome.printerProvider API, yazıcı yöneticisinin uzantılar tarafından kontrol edilen yazıcıları sorgulamak, özelliklerini sorgulamak ve bu yazıcılara yazdırma işleri göndermek için kullandığı etkinlikleri gösterir.

printing
Chrome 81 ve üstü Yalnızca ChromeOS

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

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

Baskı kullanımıyla ilgili verileri almak için chrome.printingMetrics API'yi kullanın.

gizlilik

Chrome'daki 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ündeki ChromeSetting prototipini kullanır.

işlemler
Yeni geliştirilenler kanalı

Tarayıcı işlemlerini etkileşime geçirmek 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ündeki ChromeSetting prototipini kullanır.

runtime

Hizmet işçisini almak, manifest ile ilgili ayrıntıları döndürmek ve uzantı yaşam döngüsündeki etkinlikleri dinleyip yanıtlamak için chrome.runtime API'yi kullanın. URL'lerin göreceli yolunu tam nitelikli URL'lere dönüştürmek için de bu API'yi 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.

storage

Kullanıcı verilerindeki değişiklikleri 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

Görüntülü reklam meta verilerini sorgulamak için system.display API'yi kullanın.

system.memory

chrome.system.memory API'si.

system.storage

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

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

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

tabCapture

Sekme medya akışlarıyla etkileşime geçmek için chrome.tabCapture API'yi kullanın.

sekmeler

Tarayıcı sekme sistemiyle etkileşime geçmek için chrome.tabs API'yi kullanın. Tarayıcıda sekme oluşturmak, değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz.

topSites

Yeni sekme sayfasında gösterilen en popüler sitelere (ör. en çok ziyaret edilen siteler) erişmek için chrome.topSites API'yi kullanın. Kullanıcı tarafından özelleştirilen kısayollar bu kapsamda değildir.

tts

Sentezlenmiş metin okuma (TTS) özelliğini oynatmak için chrome.tts API'yi kullanın. Ayrıca, bir uzantının konuşma motoru uygulamasına izin veren ilgili ttsEngine API'ye de bakın.

ttsEngine

Uzantı kullanarak metin okuma(TTS) motoru uygulamak için chrome.ttsEngine API'yi kullanın. Uzantılarınız bu API'yi kullanarak kaydedilirse herhangi bir uzantı veya Chrome uygulaması konuşma oluşturmak için tts API'yi kullandığında, seslendirilecek bir ifade ve diğer parametreleri içeren etkinlikler alır. Ardından uzantınız, konuşmayı sentezlemek ve yayınlamak için mevcut herhangi bir web teknolojisini kullanabilir ve durumu bildirmek için etkinlikleri çağıran işleve geri gönderebilir.

types

chrome.types API'si, Chrome için tür tanımlarını içerir.

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

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

wallpaper
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

Gezinme isteklerinin durumuyla ilgili bildirimler almak için chrome.webNavigation API'yi kullanın.

webRequest

Trafiği gözlemlemek ve analiz etmek, aktarımdaki istekleri durdurmak, engellemek veya değiştirmek için chrome.webRequest API'yi kullanın.

windows

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