API referansı

Çoğu uzantının çalışması için bir veya daha fazla Chrome Uzantıları 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, tek tek erişilebilirlik özelliklerini almak ve ayarlamak için ChromeSetting tür API'nin prototipine dayanır. Özellik durumlarını almak için uzantının accessibilityFeatures.read izni istemesi gerekir. Uzantının özellik durumunu değiştirmek için accessibilityFeatures.modify izni gerekir. accessibilityFeatures.modify izninin accessibilityFeatures.read izni anlamına gelmediğini unutmayın.

alarms

Kodu periyodik olarak veya gelecekte belirli bir zamanda çalışacak şekilde planlamak için chrome.alarms API'sini 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'in kiosk modunda kullanılabilir.

yer işaretleri

Yer işaretlerini oluşturmak, düzenlemek ve başka şekillerde değiştirmek için chrome.bookmarks API'yi kullanın. Özel bir Yer İşareti Yöneticisi sayfası oluşturmak için kullanabileceğiniz Override Pages'e de bakın.

browserAction

≤ MV2

Tarayıcı işlemlerini kullanarak adres çubuğunun sağındaki ana Google Chrome araç çubuğuna simgeler yerleştirin. Tarayıcı işleminin simgesinin yanı sıra ipucu, rozet ve pop-up'ı da olabilir.

browsingData

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

certificateProvider

Chrome 46 veya daha yeni bir sürüm Yalnızca ChromeOS

Bu API'yi, sertifikaları platforma sunmak için kullanın. Platform, bu sertifikaları TLS kimlik doğrulamaları için kullanabilir.

commands

Uzantınızda işlemleri tetikleyen klavye kısayolları eklemek için Commands API'yi kullanın. Örneğin, tarayıcı işlemini açma veya uzantıya komut gönderme işlemleri.

contentSettings

Web sitelerinin çerezler, JavaScript ve eklentiler gibi özellikleri kullanıp kullanamayacaklarını belirleyen ayarları değiştirmek için chrome.contentSettings API'yi kullanın. Daha genel olarak, 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 hangi tür nesneler için geçerli olacağını (ör. resimler, köprüler ve sayfalar) seçebilirsiniz.

cookies

Çerezleri sorgulamak, değiştirmek ve değiştiğinde bildirim almak için chrome.cookies API'sini kullanın.

hata ayıklayıcı

chrome.debugger API, Chrome'un uzaktan hata ayıklama protokolü için alternatif bir aktarım görevi görür. Ağ etkileşimini ölçmek, JavaScript'te hata ayıklamak, DOM ve CSS'yi değiştirmek ve daha fazlası için chrome.debugger simgesini kullanarak bir veya daha fazla sekmeye bağlanın. Debuggee özelliğini kullanarak sendCommand ile sekmeleri hedefleyin ve onEvent geri çağırmalarından gelen etkinlikleri tabId ile yönlendirin.tabId

declarativeContent

Sayfa içeriğini okuma izni gerektirmeden, sayfa içeriğine bağlı olarak işlem yapmak için chrome.declarativeContent API'sini kullanın.

declarativeNetRequest

Chrome 84+

chrome.declarativeNetRequest API, bildirim temelli kurallar belirtilerek ağ isteklerini engellemek veya değiştirmek için kullanılır. Bu sayede uzantılar, ağ isteklerini engellemeden 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'yi inceleyin. Devam eden istekleri yakalamak, 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. Bunun nedeni, JavaScript motoru yerine tarayıcıda değerlendirilen kurallar kaydedebilmenizdir. Bu sayede gidiş dönüş gecikmeleri azalır ve daha yüksek verimlilik elde edilebilir.

desktopCapture

Masaüstü Yakalama API'si, ekranın, bağımsız pencerelerin veya bağımsız sekmelerin içeriğini 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 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österilen ağ istekleriyle ilgili bilgileri almak için chrome.devtools.network API'yi kullanın.

devtools.panels

Uzantınızı Geliştirici Araçları penceresi 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 veya daha yeni bir sürüm

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 veya daha yeni bir sürüm

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

dns

Yeni geliştirilenler kanalı

DNS çözümlemesi için chrome.dns API'sini kullanın.

documentScan

Chrome 44 veya daha yeni bir sürüm Yalnızca ChromeOS

Ekli belge tarayıcılardan görüntüleri 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'sini kullanın.

downloads

İndirmeleri programatik olarak başlatmak, izlemek, değiştirmek ve aramak için chrome.downloads API'sini 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üklenen 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 politika tarafından yüklenen uzantılar için kullanılabilir.

enterprise.login

Beklemede Yalnızca ChromeOS Politika gerektirir

Kullanıcı oturumlarından çıkmak için chrome.enterprise.login API'yi kullanın. Not: Bu API yalnızca ChromeOS'teki yönetilen oturumlarda kurumsal politika tarafından 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üklenen uzantılar için kullanılabilir.

enterprise.platformKeys

Yalnızca ChromeOS Politika gerektirir

Bu anahtarlar için anahtar oluşturmak ve sertifika yüklemek üzere 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. Message Passing (Mesaj Geçirme) bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile içerik komut dosyaları arasında veya uzantılar arasında mesaj alışverişi desteği içerir.

extensionTypes

chrome.extensionTypes API, Chrome uzantıları için tür bildirimlerini 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üklemesini sağlamak 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'sini kullanın.

fontSettings

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

gcm

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

history

Ziyaret edilen sayfaların tarayıcı kaydıyla etkileşimde bulunmak için chrome.history API'sini kullanın. Tarayıcının geçmişine URL ekleyebilir, URL 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ını almak için chrome.identity API'sini kullanın.

idle

Makinenin boşta kalma durumu değiştiğinde bunu 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 veya daha yeni bir sürüm

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

loginState

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

Oturum açma durumunu okumak ve izlemek için chrome.loginState API'yi kullanın.

yönetimi

chrome.management API, yüklü uygulamaları ve uzantıları yönetme yöntemleri sunar.

notifications

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

omnibox

Omnibox API, Google Chrome'un adres çubuğuna (omnibox olarak da bilinir) bir anahtar kelime kaydetmenize olanak tanır.

pageAction

≤ MV2

chrome.pageAction API'sini kullanarak adres çubuğunun sağındaki ana Google Chrome araç çubuğuna simgeler yerleştirin. Sayfa işlemleri, geçerli sayfada yapılabilecek ancak tüm sayfalar için geçerli olmayan işlemleri ifade eder. Sayfa işlemleri, etkin olmadığında gri görünür.

pageCapture

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

izinler

Kullanıcıların izinlerin neden gerekli olduğunu anlaması ve yalnızca gerekli olanları vermesi için chrome.permissions API'sini kullanarak bildirilen isteğe bağlı izinleri yükleme zamanında değil, çalışma zamanında isteyin.

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'sini kullanın. Kullanıcı veya politika izni 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'a bakın).

power

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

printerProvider

Chrome 44 veya daha yeni bir sürüm

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

baskı

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

Chromebook'a yüklenen yazıcılara yazdırma işleri göndermek için chrome.printing API'sini 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

Kullanıcının gizliliğini etkileyebilecek Chrome özelliklerinin kullanımını kontrol etmek için chrome.privacy API'sini kullanın. Bu API, Chrome'un yapılandırmasını almak ve ayarlamak için API türünün ChromeSetting prototipine dayanır.

processes

Yeni geliştirilenler kanalı

Tarayıcının işlemleriyle etkileşim kurmak 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 ChromeSetting türündeki API'nin ChromeSetting prototipine dayanır.

runtime

Service worker'ı almak, manifestle 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. Bu API'yi, URL'lerin göreceli 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'sini kullanın.

oturumlar

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

storage

Kullanıcı verilerinde yapılan değişiklikleri depolamak, almak ve izlemek için chrome.storage API'sini kullanın.

system.cpu

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

system.display

Yayınlanan içerik 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 bir depolama cihazı takıldığında veya çıkarıldığında bildirim almak için chrome.system.storage API'sini 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şim kurmak için chrome.tabCapture API'sini kullanın.

sekmeler

Tarayıcının sekme sistemiyle etkileşim kurmak için chrome.tabs API'sini kullanın. Bu API'yi kullanarak tarayıcıda sekmeler oluşturabilir, değiştirebilir ve yeniden düzenleyebilirsiniz.

topSites

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

tts

Sentezlenmiş metin okuma (TTS) oynatmak için chrome.tts API'yi kullanın. Bir uzantının konuşma motoru uygulamasına olanak tanıyan ilgili ttsEngine API'ye de göz atı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 kaydolursa herhangi bir uzantı veya Chrome uygulaması konuşma oluşturmak için tts API'sini kullandığında, konuşulacak bir ifade ve diğer parametreleri içeren etkinlikler alır. Uzantınız daha sonra konuşmayı sentezlemek ve çıkışını yapmak için mevcut web teknolojilerini kullanabilir ve durumu bildirmek için etkinlikleri çağıran işleve geri gönderebilir.

types

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

vpnProvider

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

VPN istemcisi 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

Devam eden gezinme isteklerinin durumuyla ilgili bildirim almak için chrome.webNavigation API'sini kullanın.

webRequest

Trafiği gözlemlemek ve analiz etmek, ayrıca devam eden istekleri engellemek, değiştirmek veya bunlara müdahale etmek için chrome.webRequest API'sini kullanın.

windows

Tarayıcı pencereleriyle etkileşimde bulunmak için chrome.windows API'sini kullanın. Bu API'yi kullanarak tarayıcıda pencereler oluşturabilir, bunları değiştirebilir ve yeniden düzenleyebilirsiniz.