Çoğu uzantının çalışması için bir veya daha fazla Chrome Extensions API'sine erişmesi gerekir. Bu API referansında, kullanılabilecek API'ler açıklanmaktadır kullanım örneklerine yer verir.
Yaygın Extensions API özellikleri
Extensions API, uzantıların çalışması için yöntemleri ve özellikleri içeren ve genellikle
her zaman, manifest.json
dosyasının manifest alanlarını içerir. Örneğin, chrome.action
ad alanı için "action"
nesnesi gerekir
dosyası olarak gönderin. Birçok API, manifest dosyasında da izinleri gerektirir.
Uzantı API'lerindeki yöntemler, aksi belirtilmedikçe eşzamansız olur. Eşzamansız yöntemler beklemeden, anında geri döner . Bu yöntemlerin sonuçlarını almak için vaatleri kullanın. Daha fazla bilgi için Eşzamansız yöntemler bölümüne bakın.
Chrome Uzantı API'leri
- 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ınaccessibilityFeatures.read
izni istemesi gerekir. Özellik durumunu değiştirmek için uzantınınaccessibilityFeatures.modify
iznine ihtiyacı var.accessibilityFeatures.modify
işlevininaccessibilityFeatures.read
iznini ima etmediğini unutmayın. - işlem
-
Chrome 88 ve sonraki sürümler MV3+
Google Chrome araç çubuğundaki uzantının simgesini kontrol etmek için
chrome.action
API'sini kullanı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. - 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 Komutlar API'sini 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. - hata ayıklayıcı
-
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çinchrome.debugger
kullanın.sendCommand
içeren sekmeleri hedeflemek ve etkinliklerionEvent
geri çağırmalarındantabId
tarihine göre yönlendirmek içinDebuggee
özelliğinitabId
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 'nı inceleyin.
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. - desktopCapture
-
Desktop Capture API ekranın içeriğini, tek tek pencereleri veya tek tek sekmeleri yakalar.
- devtools.inspectedWindow
-
Denetlenen 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.performance
-
Beklemede
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 sonraki sürümler 'nı inceleyin.
Geliştirici Araçları'ndaki Kaydedici panelini özelleştirmek için
chrome.devtools.recorder
API'yi kullanın. - dns
-
Yeni geliştirilenler kanalı 'nı inceleyin.
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 'nı inceleyin.
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
-
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 'nı inceleyin. 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
-
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 'nı inceleyin. 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 'nı inceleyin.
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 'nı inceleyin.
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 'nı inceleyin.
Ö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ı sunar. - 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. - ekran dışı
-
Chrome 109 ve sonraki sürümler MV3+
Ekran dışı dokümanlar oluşturmak ve yönetmek için
offscreen
API'yi 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.
- 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. Ör. Bu ayar, üçüncü taraf VPN'lerde platform tarafından yönetilen sertifikaların kullanılmasına izin verir (chrome.vpnProvider sayfasına 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 'nı inceleyin.
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
-
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ı 'nı inceleyin.
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. - readingList
-
Chrome 120 ve sonraki sürümler MV3+
Okuma Listesi'ndeki öğelerde okuma ve değişiklik yapmak için
chrome.readingList
API'sini kullanın. - ç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. - komut dosyası oluşturma
-
Chrome 88 ve sonraki sürümler MV3+
Komut dosyasını farklı bağlamlarda yürütmek için
chrome.scripting
API'yi kullanın. - search
-
Chrome 87 ve sonraki sürümler 'nı inceleyin.
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. - sidePanel
-
Chrome 114 ve sonraki sürümler MV3+
İçeriği, bir web sayfasının ana içeriğinin yanı sıra tarayıcının yan panelinde barındırmak için
chrome.sidePanel
API'sini 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
-
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. - tabGroups
-
Chrome 89 ve sonraki sürümler MV3+
Tarayıcının sekme gruplama sistemiyle etkileşimde bulunmak için
chrome.tabGroups
API'sini kullanın. Bu API'yi, tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için kullanabilirsiniz. Sekmeleri gruplandırıp gruplandırmak veya gruplarda hangi sekmelerin bulunduğunu sorgulamak içinchrome.tabs
API'yi 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 ilgilittsEngine
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çintts
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. - userScripts
-
Chrome 120 ve sonraki sürümler MV3+
Kullanıcı komut dosyalarını Kullanıcı Komut Dosyaları bağlamında yürütmek için
userScripts
API'yi kullanın. - 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. - webAuthenticationProxy
-
Chrome 115 ve sonraki sürümler MV3+
chrome.webAuthenticationProxy
API, uzak ana makine üzerinde çalışan uzaktan masaüstü yazılımının, yerel bir istemcide işlemek üzere Web Authentication API (WebAuthn) isteklerine müdahale etmesine olanak tanır. - 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.