Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
API
Las API de JavaScript para las Extensiones Web se pueden usar dentro de losscripts en segundo plano de la extensión y en cualquier otro documento contenido en la extensión, incluyendo las ventanas emergentes deacción de página oacción del navegador,barras laterales,páginas de opciones opáginas de pestañas nuevas. A algunas de estas API también se puede acceder mediante losscripts de contenido de una extensión ( consulte lalista en la guía de script de contenido).
Para usar API más poderosas debessolicitar permiso en manifest.json en tu extensión.
Puedes acceder a las API utilizando el namespacebrowser:
function logTabs(tabs) { console.log(tabs);}browser.tabs.query({ currentWindow: true }, logTabs);Muchas de las APIs son asíncronas, devolviendo unPromise:
function logCookie(c) { console.log(c);}function logError(e) { console.error(e);}var setCookie = browser.cookies.set({ url: "https://developer.mozilla.org/" });setCookie.then(logCookie, logError);Tenga en cuenta que esto es diferente del sistema de extensiones de Google Chrome, que utiliza el nombrechrome en lugar debrowser, y que utilizacallbacks en lugar depromise para funciones asíncronas. Como ayuda para portar, la implementación de Firefox de la API WebExtensions admitechrome ycallbacks, así comobrowser ypromise. Mozilla también ha escrito unpolyfill que habilita el código que usabrowser ypromise para trabajar sin cambios en Chrome.:https://github.com/mozilla/webextension-polyfill.
Firefox también implementa estas APIs bajo el nombrechrome usandocallbacks. Esto permite que el código escrito para Chrome se ejecute sin cambios en Firefox para las APIs documentadas aquí.
Microsoft Edge usa el namespacebrowser, pero aún no admite APIs asíncronas basadas enpromise. En Edge, por el momento, las APIs asíncronas deben utilizarcallbacks.
No todos los navegadores son compatibles con todas las APIs: para obtener más información, consulteSoporte del navegador para las API de JavaScript.
Listado de API de JavaScript
Vea a continuación una lista completa de las API de #"/es/docs/Mozilla/Add-ons/WebExtensions/API/i18n">i18n
Funciones para internacionalizar su extensión. Es posible utilizar estas API para obtener cadenas de texto traducidas a partir de archivos de configuración regional incluidos en la extensión, conocer el idioma actual del navegador y recuperar el valor de sucabecera Accept-Language.
Permite que las extensiones almacenen y recuperen datos, y escuchen los cambios realizados en los elementos almacenados.
Incompatibilidades con Chrome
Nosotros no soportamos ninguna API que no es listada arriba.
Incluso, para las APIs que están listadas arriba, no siempre soportamos todas las propiedades que Chrome soporta. Por favor, chequea la página de la API para cualquier incompatibilidad con Chrome.