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.

Chrome 148'den itibaren bu API'ler, chrome için tarayıcılar arası bir alternatif olarak browser ad alanında da kullanılabilir. Kullanım kılavuzu için Tarayıcı ad alanı bölümüne bakın.

Ortak Extensions API özellikleri

Extensions API, uzantı çalışmalarını gerçekleştirmek için yöntemler ve özellikler içeren bir ad alanından ve genellikle (ancak her zaman değil) manifest.json dosyası için manifest alanlarından oluşur. Örneğin, browser.action ad alanı, manifestte bir "action" nesnesi gerektirir. Birçok API, manifest dosyasında izinler de gerektirir.

Uzantı API'lerindeki yöntemler, aksi belirtilmedikçe eşzamansız olur. Eşzamansız yöntemler, kendilerini çağıran işlemin tamamlanmasını beklemeden hemen sonuç döndürür. Bu eşzamansız yöntemlerin sonuçlarını almak için promise'ları kullanın.

Chrome Uzantısı API'leri

accessibilityFeatures

Chrome'un erişilebilirlik özelliklerini yönetmek için chrome.accessibilityFeatures API'sini kullanın. Bu API, erişilebilirlik özelliklerini tek tek almak ve ayarlamak için ChromeSetting türü API 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, accessibilityFeatures.read izni anlamına gelmez.

action
Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.* MV3 ve sonraki sürümler

Google Chrome araç çubuğundaki uzantı simgesini kontrol etmek için chrome.action API'sini kullanın.

alarms

Kodun düzenli olarak veya gelecekte belirli bir zamanda çalıştırılmasını planlamak için chrome.alarms API'yi kullanın.

audio
Chrome 59 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS

chrome.audio API'si, kullanıcıların sisteme bağlı ses sistemleri 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 işlemler yapmak için chrome.bookmarks API'yi kullanın. Özel bir Yer İşareti Yöneticisi sayfası oluşturmak için kullanabileceğiniz Geçersiz Kılma Sayfaları'na da bakın.

browsingData

Kullanıcının yerel profilinden tarama verilerini kaldırmak için chrome.browsingData API'sini kullanın.

certificateProvider
Chrome 46 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS

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

commands

Uzantınızda işlem 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şlemi.

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 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'sini kullanın. Bağlam menüsü eklemelerinizin hangi nesne türleri (ör. resimler, köprüler ve sayfalar) için geçerli olacağını seçebilirsiniz.

çerezler

Çerezleri sorgulamak ve değiştirmek, ayrıca çerezler değiştiğinde bildirim almak için chrome.cookies API'yi 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 bir veya daha fazla sekmeye eklemek üzere chrome.debugger kullanın. sendCommand ile sekmeleri hedeflemek ve onEvent geri çağırmalarından tabId ile etkinlikleri yönlendirmek için Debuggee özelliğini tabId kullanın.

declarativeContent

Sayfa içeriğini okuma izni gerektirmeden sayfanın içeriğine göre işlem yapmak için chrome.declarativeContent API'yi kullanın.

declarativeNetRequest
Chrome 84 ve sonraki sürümler Chrome 148'den itibaren browser.*

chrome.declarativeNetRequest API'si, bildirim temelli kurallar belirterek ağ isteklerini engellemek veya değiştirmek için kullanılır. Bu sayede uzantılar, ağ isteklerini kesintiye uğratmadan ve içeriklerini görüntülemeden değiştirebilir. Böylece daha fazla gizlilik sağlanır.

desktopCapture

Desktop Capture API, 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'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

Geliştirici Araçları tarafından Ağ panelinde 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 ve sonraki sürümler Chrome 152'den itibaren browser.*

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

devtools.recorder
Chrome 105 ve sonraki sürümler Chrome 152'den itibaren browser.*

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ümleme için chrome.dns API'sini kullanın.

documentScan
Chrome 44 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS

Bağlı 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 Chrome 148'den itibaren browser.*

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

indirme sayısı

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

enterprise.deviceAttributes
Chrome 46+ Chrome 148'den itibaren browser.* 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 yüklenen uzantılar tarafından kullanılabilir.

enterprise.hardwarePlatform
Chrome 71 ve sonraki sürümler Chrome 148'den itibaren browser.* Politika gerektirir

Tarayıcının çalıştığı donanım platformunun üreticisini ve modelini öğrenmek için chrome.enterprise.hardwarePlatform API'sini kullanın. Not: Bu API yalnızca kurumsal politika tarafından yüklenen uzantılarda kullanılabilir.

enterprise.login
Chrome 139 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS Politika gerektirir

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

enterprise.networkingAttributes
Chrome 85 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS Politika gerektirir

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

enterprise.platformKeys
Yalnızca ChromeOS Politika gerektirir

Anahtar oluşturmak ve bu anahtarlar için sertifika yüklemek üzere chrome.enterprise.platformKeys API'sini 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'si, herhangi bir uzantı sayfası tarafından kullanılabilen yardımcı programlara sahiptir. Mesaj Aktarma 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'si, Chrome uzantıları için tür bildirimleri içerir.

fileBrowserHandler
Yalnızca ChromeOS Yalnızca ön plan

ChromeOS 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'sini 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 politikasını kullanın.

geçmiş

Tarayıcının ziyaret edilen sayfalar kaydıyla etkileşimde bulunmak için chrome.history API'sini kullanın. Tarayıcı geçmişine URL ekleyebilir, geçmişten URL kaldırabilir ve geçmişteki 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ırma uygulamak için chrome.i18n altyapısını kullanın.

identity

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

idle

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

input.ime
Yalnızca ChromeOS

ChromeOS için özel bir IME uygulamak üzere chrome.input.ime API'sini kullanın. Bu sayede uzantınız tuş vuruşlarını işleyebilir, oluşturmayı ayarlayabilir ve aday penceresini yönetebilir.

instanceID
Chrome 44 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

loginState
Chrome 78+ Chrome 148'den itibaren browser.* Yalnızca ChromeOS

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

yönetimi

chrome.management API'si, yüklü uygulamaları ve uzantıları yönetmenin yollarını sunar.

mimeHandler
Chrome 151+

Üçüncü taraf uzantılarında MIME türü akışlarını işlemek için chrome.mimeHandler API'sini kullanın.

notifications

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

ekran dışında
Chrome 109 ve sonraki sürümler Chrome 148'den itibaren browser.* MV3 ve sonraki sürümler

Ekran dışı dokümanlar oluşturmak ve yönetmek için offscreen API'yi kullanın.

omnibox

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

pageCapture

Sekmeyi MHTML olarak kaydetmek için chrome.pageCapture API'yi kullanın.

izinler

Beyan edilen isteğe bağlı izinleri yükleme zamanı yerine çalışma zamanında istemek için chrome.permissions API'sini kullanın. Böylece kullanıcılar izinlerin neden gerekli olduğunu anlayabilir ve yalnızca gerekli olan izinleri verebilir.

platformKeys
Chrome 45+ Chrome 148'den itibaren browser.* 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 sayede üçüncü taraf VPN'lerde platform tarafından yönetilen sertifikalar kullanılabilir (chrome.vpnProvider sayfasına bakın).

power

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

printerProvider
Chrome 44 ve sonraki sürümler Chrome 148'den itibaren browser.*

chrome.printerProvider API'si, yazdırma 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.

yazdırma
Chrome 81 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS

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

printingMetrics
Chrome 79 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS Politika gerektirir

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

gizlilik

Chrome'da kullanıcının 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 tür API'sinin ChromeSetting prototipini kullanır.

işlemler
Yeni geliştirilenler kanalı

Tarayıcının işlemleriyle etkileşim kurmak için chrome.processes API'sini kullanın.

proxy

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

publicSuffix
Chrome 153+

Tarayıcının Genel Ek Listesi'ni (PSL) sorgulamak için chrome.publicSuffix API'yi kullanın.

readingList
Chrome 120 ve sonraki sürümler Chrome 148'den itibaren browser.* MV3 ve sonraki sürümler

Okuma Listesi'ndeki öğeleri okumak ve değiştirmek için chrome.readingList API'yi kullanın.

runtime

Hizmet çalışanını 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. Bu API'yi, URL'lerin göreli yolunu tam nitelikli URL'lere dönüştürmek için de kullanabilirsiniz.

komut dosyası çalıştırma
Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.* MV3 ve sonraki sürümler

Komut dosyasını farklı bağlamlarda yürütmek için chrome.scripting API'sini kullanın.

search
Chrome 87 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

oturumlar

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

sidePanel
Chrome 114+ Chrome 148'den itibaren browser.* MV3+

İçeriği, web sayfasının ana içeriğiyle birlikte tarayıcının yan panelinde barındırmak için chrome.sidePanel API'yi kullanın.

storage

Kullanıcı verilerini depolamak, almak ve verilerde yapılan değişiklikleri 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

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ılıp çıkarıldığında bildirim almak için chrome.system.storage API'yi kullanın.

systemLog
Chrome 125 ve sonraki sürümler Chrome 148'den itibaren browser.* 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'yi kullanın.

tabGroups
Chrome 89 ve sonraki sürümler Chrome 148'den itibaren browser.* MV3 ve sonraki sürümler

Tarayıcının sekme gruplandırma sistemiyle etkileşimde bulunmak için chrome.tabGroups API'yi kullanın. Tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz. Sekmeleri gruplandırmak ve gruplandırmasını kaldırmak ya da gruplarda hangi sekmelerin olduğunu sorgulamak için chrome.tabs API'sini kullanın.

tabs

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

topSites

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

tts

Sentezlenmiş metin okuma (TTS) sesini çalmak için chrome.tts API'yi kullanın. Uzantıların konuşma motoru uygulamasını sağlayan ilgili ttsEngine API'sini de inceleyin.

ttsEngine

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'yi kullandığında, söylenecek 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 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 bildirimleri içerir.

userScripts
Chrome 120 ve sonraki sürümler Chrome 148'den itibaren browser.* MV3 ve sonraki sürümler

Kullanıcı komut dosyalarını, kullanıcı komut dosyaları bağlamında yürütmek için userScripts API'sini kullanın.

vpnProvider
Chrome 43 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS

VPN istemcisini uygulamaya almak için chrome.vpnProvider API'sini kullanın.

duvar kağıdı
Chrome 43 ve sonraki sürümler Chrome 148'den itibaren browser.* Yalnızca ChromeOS

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

webAuthenticationProxy
Chrome 115+ Chrome 148'den itibaren browser.* MV3+

chrome.webAuthenticationProxy API, uzak bir ana makinede çalışan uzaktan masaüstü yazılımının, yerel bir istemcide işlemek için Web Authentication API (WebAuthn) isteklerini yakalamasına olanak tanır.

webNavigation

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

webRequest

Trafiği gözlemleyip analiz etmek ve aktarım halindeki istekleri yakalamak, engellemek veya değiştirmek için chrome.webRequest API'sini kullanın.

windows

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