https://github.com/mdn/webextensions-examples
Mantenido por el equipo complementario de Mozilla.
WeBextensions son una forma de escribir extensiones del navegador: es decir, programas instalados dentro de un navegador web que modifican el comportamiento del navegador o páginas web cargadas por el navegador. Weebextensions se basa en un conjunto de API de navegador cruzado, por lo que Weebextensions escritas para Google Chrome, Opera o Edge también se ejecutará en Firefox.
El repositorio "Webextensions-Examples" es una colección de WeBextensions simples, completos e instalables. Los ejemplos muestran cómo usar las API WeBextensions, y puede usarlas como punto de partida para sus Webextensions.
Para obtener un índice de todos los ejemplos, consulte la página "Extensiones de ejemplo" en MDN.
Los ejemplos están disponibles bajo la Licencia Pública de Mozilla 2.0.
Para usar el repositorio, primero clonarlo.
Cada ejemplo se encuentra en una carpeta de nivel superior e incluye un rectificador corto que explica lo que hace. Para ver cómo funciona un ejemplo, instálelo en Firefox siguiendo las instrucciones de instalación.
Para encontrar su camino alrededor de la estructura interna de una Webextension, eche un vistazo a la anatomía de una página de Webextension en MDN.
Para usar estos ejemplos en Firefox, use la liberación más reciente de Firefox. Sin embargo, la mayoría de los ejemplos trabajan con lanzamientos anteriores.
Algunos ejemplos se basan en API que solo están disponibles en versiones previas a la liberación de Firefox. Cuando este es el caso, el ejemplo declara la versión mínima que necesita en el atributo strict_min_version
de la browser_specific_settings key
en el archivo Manifest.json de la extensión.
Algunos ejemplos solo funcionan en dominios o páginas específicos. Los detalles de cualquier restricción se proporcionan en el archivo ReadMe de cada ejemplo. Ninguno de los ejemplos funciona en ventanas de navegación privada de forma predeterminada, consulte Extensiones en navegación privada para más detalles.
Para ejecutar una extensión de ejemplo:
about:debugging
. Haga clic en Cargar el complemento temporal y seleccione el archivo manifest.json
dentro de la carpeta de una extensión de ejemplo. Aquí hay un video que demuestra cómo hacer esto.web-ext run
. Esto lanza Firefox e instala la extensión automáticamente. Esta herramienta proporciona algunas características de desarrollo adicionales, como la recarga automática. Estos ejemplos se prueban en Firefox. Pueden trabajar en otros navegadores, si el navegador admite las API utilizadas. Tenga en cuenta que todos estos ejemplos usan el espacio de nombres browser
y promete trabajar con funciones asíncronas. Esto significa que los ejemplos no funcionarán en Chrome a menos que use el polyfill proporcionado por Mozilla. Consulte la descripción general de las API WeBextension para obtener más información.
Para obtener más información sobre el desarrollo de WeBextensions, consulte la documentación de Webextensions en MDN para obtener guías iniciales, tutoriales y documentos completos de referencia de API.
Si te encuentras con un problema:
Si no puede resolver el problema, presente un error.
Agradecemos las contribuciones, ya sean nuevos ejemplos, nuevas características, correcciones de errores o traducciones de cadenas localizables. Consulte el archivo contribuyente.md para obtener más detalles.