Qué es una extensión de navegador: si sabes páginas web, sabes extensiones
💡 Resumen en una frase: una extensión de navegador es un mini programa que corre dentro de Chrome — puedes hacerla con el mismo HTML/CSS/JS con el que se escriben páginas web, y puede modificar la interfaz, modificar páginas web e interceptar peticiones; en cuanto al desarrollo, la IA escribe el código y tú te encargas de las ideas y de la validación.
Si buscas «desarrollo de extensiones de navegador», los primeros tutoriales que aparecen sueltan en la primera pantalla manifest_version, MV3, service worker, content script, y quien parte de cero abandona al segundo párrafo. Esta lección no escribe ni una línea de código: primero deja claro lo más importante: qué es exactamente una extensión de navegador, qué puede hacer, por qué «si sabes páginas web, sabes extensiones» y cuántos pasos hay de la idea a la publicación.
Es la lección 1 de la ruta C de la práctica por escenarios (crear extensiones de navegador), y también es el cimiento de toda la ruta — cada operación de las seis lecciones siguientes se construye sobre los conceptos de esta.
- ¿Aún no has elegido ruta? Vuelve a 4.0 Práctica por escenarios: elige tu ruta
- ¿Lo que quieres hacer en realidad es «un sitio web con una URL pública»? Mira A1 Crear sitios web con IA
- ¿Quieres hacer un servicio que «se difunda dentro de WeChat»? Mira B1 Qué es un mini programa de WeChat
Qué podrás hacer al terminar
- Explicar con la definición oficial de Chrome «qué es una extensión de navegador»: personalizar la interfaz, escuchar eventos del navegador, modificar páginas web
- Enumerar las cinco capacidades centrales de una extensión: ventana emergente en la barra de herramientas, barra lateral, interceptación de peticiones de red, inyección de scripts en páginas web, escucha de eventos en segundo plano
- Explicar por qué «si sabes páginas web, sabes extensiones»: la pila tecnológica es HTML/CSS/JS, más un archivo manifest.json
- Recordar las tres líneas rojas para publicar en la Chrome Web Store: propósito único, cumplir las políticas, todo el código empaquetado
- Dibujar el mapa de las siete lecciones de la ruta C y saber en qué lección se desarrolla cada concepto
Tu situación actual
- «Traducción, captura de pantalla, filtrado de anuncios… ¿cómo se han hecho realmente estas extensiones que uso todos los días?»
- «Busco desarrollo de extensiones chrome y la primera pantalla de los tutoriales ya habla de manifest, MV3, service worker; no reconozco ni una palabra»
- «Puedo hacer que la IA escriba páginas web, pero las extensiones parecen otro mundo — ¿es fiable que la IA escriba extensiones?»
Cuándo usar esta técnica
Cuando necesitas:
- Transformar el propio navegador: añadir botones en cualquier página web, bloquear elementos, cambiar estilos, extraer contenido
- Una herramienta residente en el navegador — se usa con un clic en el icono de la barra de herramientas, sin abrir antes un sitio web
- Crear herramientas de productividad donde «tú mismo eres el primer usuario»: traducción de texto seleccionado, gestión de pestañas, autorrelleno de formularios
Y además no quieres:
- Aprender un lenguaje nuevo — las extensiones usan el mismo HTML/CSS/JS de las páginas web
- Montar un proyecto desde cero — en su forma mínima, una extensión es una carpeta con unos archivos
- Ocuparte de servidores — la extensión corre en el navegador, se carga en local y funciona, sin necesidad de desplegar
¿Lo que has creado te gustaría más que «cualquiera pueda acceder por URL»? Eso es cosa de la ruta A, vuelve a A1 Crear sitios web con IA.
🎒 Preparativos antes de empezar
- Haber completado 4.0 Práctica por escenarios: elige tu ruta y confirmar que lo que quieres es «una herramienta dentro del navegador»
- Tener el navegador Chrome instalado en el ordenador (la ruta C se basa en Chrome; en esta lección solo se mira, no se actúa)
- 8 minutos de lectura; esta lección no requiere escribir ningún código
Idea central
Primero, aclarar los nombres: lo que la documentación oficial llama Chrome extensions, la comunidad china suele llamarlo «Extensión de navegador» o «Chrome 插件»; en este curso se usan ambos nombres indistintamente.
La documentación oficial de Chrome ha dado una definición de una frase:
Chrome extensions enhance the browsing experience by customizing the user interface, observing browser events, and modifying the web. (Las extensiones de Chrome mejoran la experiencia de navegación personalizando la interfaz, observando los eventos del navegador y modificando la web.)
Traducido a lenguaje llano: una extensión es un mini programa con el que «el navegador te permite oficialmente transformarlo», y hace tres cosas:
| # | Definición oficial | en lenguaje llano |
|---|---|---|
| 1 | customizing the user interface | añadir tu propia interfaz al navegador (botones, ventanas emergentes, barra lateral) |
| 2 | observing browser events | escuchar cada acción del navegador (abrir pestañas, cerrar pestañas, borrar marcadores) |
| 3 | modifying the web | modificar la página que estás viendo (añadir elementos, cambiar estilos, interceptar peticiones) |
Para quien empieza de cero, la frase oficial más importante es esta:
You can build extensions using the same web technologies that are used to create web applications: HTML, CSS, and JavaScript. (Puedes crear extensiones con las mismas tecnologías web que se usan para crear aplicaciones web: HTML, CSS y JavaScript.)
De aquí viene el título de esta lección — si sabes páginas web, sabes extensiones. Ya sabes hacer que la IA escriba el trío de la web; una extensión solo añade un archivo manifest.json «de instrucciones» que le dice a Chrome cómo se llama tu extensión y qué permisos necesita.
💡 Por qué es fiable que la IA escriba extensiones
Todo el código de una extensión es HTML/CSS/JS más un archivo de configuración JSON — sin compilación, sin barreras de frameworks. La documentación oficial de Chrome forma un sistema completo, de la introducción al manifest, la depuración y la publicación; cada hecho de las lecciones de la ruta C sale de esa documentación, y basta con que se la des de comer a la IA.
Hazlo conmigo
Paso 1: repasa las extensiones que usas a diario (la introducción empieza por «haberlas usado»)
Por qué: sé primero usuario, luego desarrollador. Echar un vistazo a cómo se ve el "producto terminado" es más útil que memorizar diez términos.
Operación: abre Chrome, escribe chrome://extensions en la barra de direcciones y pulsa Enter (también puedes pulsar el botón de rompecabezas de la barra de herramientas → Manage Extensions).
Deberías ver: una lista de extensiones ya instaladas. Traducción, capturas de pantalla, bloqueo de anuncios… cada extensión que puedas nombrar es, en esencia, un mini programa hecho de "una carpeta + manifest.json + HTML/CSS/JS".
- Pequeña comprobación: elige una extensión que uses a menudo y piensa si lo que hace es "modificar la interfaz", "escuchar eventos" o "modificar la página web"
Paso 2: responder "qué puede hacer una extensión" con la lista oficial de capacidades
Por qué: al plantear requisitos a la IA, si sabes decir "lo que quiero es un popup, o inyectar un script en la página", la probabilidad de que la IA lo acierte a la primera sube bastante. Esta tabla es el "catálogo de piezas" de las extensiones.
| Capacidad | Descripción oficial | Uso típico |
|---|---|---|
| Botón de la barra de herramientas (Action) | Ejecuta código al pulsar el icono de la barra de herramientas, o abre una pequeña ventana (popup) | Lanzar funciones con un clic: traducir, capturar pantalla, resumir |
| Panel lateral (Side Panel) | Muestra una interfaz personalizada en el panel lateral del navegador | Diccionario permanente, notas, barra de chat de IA |
| Intercepción de peticiones de red (DeclarativeNetRequest) | Intercepta, bloquea o modifica peticiones de red | Filtro de anuncios, bloqueo de scripts de rastreo |
| Content scripts (scripts de contenido) | Ejecuta JavaScript en el entorno de la página web | Añadir botones a la página, cambiar estilos, leer el contenido de la página |
| Servicio en segundo plano (Service workers) | Se ejecuta en segundo plano y procesa eventos del navegador (por ejemplo, borrar un marcador, cerrar una pestaña) | Escuchar cambios de pestañas, enviar notificaciones |
Aparte de estas cinco categorías, las extensiones también pueden usar las API web habituales y todo un conjunto de APIs de extensiones de Chrome: el límite de capacidades es el que marque la documentación oficial.
Deberías ver: cuando vuelvan a surgir ideas como "traducir texto seleccionado" o "bloquear popups", podrás ubicarlas; por ejemplo, para traducir hay que capturar el texto seleccionado, y eso requiere que un content script entre en la página web; el bloqueo de anuncios se apoya en interceptar peticiones de red.
Paso 3: conocer el stack tecnológico: por qué "si sabes páginas web, sabes extensiones"
Por qué: el stack tecnológico determina el coste de aprendizaje. Si para hacer extensiones hubiera que aprender primero un lenguaje nuevo, no debería aparecer en una ruta para principiantes absolutos.
La buena noticia: todo esto ya lo viste en la ruta A.
| Tecnología | En páginas web (ruta A) | En extensiones |
|---|---|---|
| HTML | Estructura de la página | Estructura de página de popups, panel lateral y página de ajustes |
| CSS | Estilos de la página | La misma forma de escribirlo |
| JavaScript | Lógica de la página | El mismo lenguaje, llamando a las APIs de extensiones de Chrome según sea necesario |
Solo hay una cosa nueva: manifest.json: un archivo de configuración JSON colocado en la carpeta raíz de la extensión, que le dice a Chrome cómo se llama la extensión, qué versión tiene y qué permisos necesita. Es el "documento de identidad + manual de instrucciones" de la extensión; C3 lo desglosa campo por campo.
Y hay una cosa que conviene recordar desde ya: para desarrollar extensiones solo se escribe Manifest V3 (MV3). En el manifest, manifest_version solo admite 3; muchos tutoriales antiguos de internet siguen usando MV2, y copiarlos tal cual es trabajo en vano: las extensiones MV2 están totalmente deshabilitadas en Chrome (desde Chrome 138, en 7 de 2025, los usuarios de todos los canales ya no pueden activarlas).
Deberías ver: ahora tienes claridad: no hay lenguaje nuevo, solo un archivo nuevo y unos cuantos grupos de APIs para consultar según haga falta.
Paso 4: recordar las tres líneas rojas de publicación para el desarrollo de extensiones de navegador
Por qué: estas tres son las líneas que Chrome oficial traza para "qué extensiones pueden publicarse". Saberlas antes de empezar te ahorra toda una ronda de rework; descubrirlas al terminar es lo que más duele a la hora de corregir.
Los tres requisitos oficiales para publicar una extensión:
- Propósito único (single purpose): la extensión debe tener un único propósito claramente definido y fácil de entender; una caja de herramientas que "puede hacerlo todo" no pasa la revisión
- Cumplir las políticas del programa para desarrolladores (developer program policies): hay normas para el contenido, el comportamiento y la privacidad
- Todo el código va dentro del paquete: palabras textuales oficiales: "all logic must be included in the extension package. This means no additional JavaScript code may be downloaded at runtime." (toda la lógica debe incluirse en el paquete de la extensión; no se permite descargar código JavaScript adicional en tiempo de ejecución)
La regla 3 es especialmente importante para el vibe coding: ¿quieres que tu extensión "tire de la lógica más reciente desde un servidor" para saltarse las actualizaciones? Camino cerrado, está prohibido expresamente por la normativa oficial.
Deberías ver: al elegir la idea tienes ahora una autocomprobación extra: ¿puedo explicar el propósito único de mi extensión en una frase? ¿Todo el código está dentro del paquete?
Paso 5: dibujar el mapa de las siete lecciones de la ruta C
Por qué: si recuerdas el mapa, las seis lecciones siguientes son solo rellenar huecos: cada lección resuelve una casilla.
La ruta C tiene siete lecciones en total; esta lección (C1) es el cimiento, y quedan seis casillas:
| Lección | Qué resuelve |
|---|---|
| C2 Tu primera extensión de Chrome | Hacer funcionar un Hello World en 15 minutos: ejemplo mínimo de manifest + tres pasos de carga local |
| C3 manifest.json a fondo | Qué significa cada campo y qué más hay que rellenar para publicar |
| C4 Content Script y Service Worker | Qué gestiona cada uno de los "brazos y piernas" y el "cerebro" de la extensión, y cuándo usar cuál |
| C5 Qué hacer cuando la extensión no funciona | Dónde encontrar los logs y cómo leer los errores |
| C6 Publicar en la Chrome Web Store | Registro de desarrollador, empaquetado en zip y todo el proceso de envío a revisión |
| C7 Revisión de la tienda y estrategia de publicación | Revisión completada en la mayoría de casos en 3 días, lanzamiento gradual y rollback |
::: consejo 💡 ¿Pueden registrarse los desarrolladores de China? Sí. En la lista de países y regiones admitidos para registrarse en Chrome Web Store aparece China (China continental). El registro requiere el pago de una tarifa única, cuyo importe se rige por la página de pago real del panel del desarrollador —C6 con detalles. :::
Deberías ver: el mapa de las siete lecciones en mente, y la siguiente lección es escribir Hello World con tus propias manos.
Punto de control ✅
- Poder recitar las tres cosas de la definición oficial: personalizar la interfaz, escuchar eventos del navegador, modificar páginas web
- Poder mencionar tres de los cinco tipos de capacidades: ventana emergente de la barra de herramientas, barra lateral, interceptar solicitudes, scripts de contenido, servicio en segundo plano
- Saber que la pila tecnológica de una extensión es simplemente HTML/CSS/JS + un archivo manifest.json, sin ningún lenguaje nuevo
- Poder mencionar las tres líneas rojas de la publicación: propósito único, cumplir las políticas, empaquetar todo el código (no se permite cargar JS de forma remota)
- Saber que ahora solo se escribe MV3, y que los tutoriales antiguos de MV2 de internet no se pueden copiar tal cual
Advertencia de errores comunes
❌ Creer que desarrollar extensiones exige aprender una tecnología nueva
¿Al oír «desarrollo» vas primero a devorar libros? No hace falta. La documentación oficial dice claramente que las extensiones usan HTML/CSS/JS; lo único nuevo es un archivo manifest.json y las Chrome API que se consultan según se necesiten.
Lo correcto: trae directamente la experiencia web acumulada en la ruta A, consulta lo que te falte y no aprendas desde cero.
❌ Copiar el código MV2 de tutoriales antiguos de internet
Muchos tutoriales populares se escribieron en la era MV2. Ahora en el manifest manifest_version solo se admite 3, y las extensiones MV2 ya están totalmente deshabilitadas en Chrome — copiar código antiguo equivale a trabajar en vano.
Lo correcto: si ves aparecer "manifest_version": 2 en un tutorial, ciérralo directamente, y guíate por la documentación oficial y la referencia rápida de campos de C3.
❌ Querer hacer lógica dinámica «descargando código desde un servidor en tiempo de ejecución»
La documentación oficial lo dice por escrito: toda la lógica debe empaquetarse en la extensión, sin descargar JavaScript adicional en tiempo de ejecución. Una extensión diseñada así no pasará la revisión.
Lo correcto: las actualizaciones de funcionalidades siguen el camino legítimo — modificar el código, subir el número de versión y volver a enviar (el ritmo se explica en C6/C7).
❌ Meter todas las funcionalidades en una sola extensión
Una extensión tipo navaja suiza que «traduce, captura pantallas y gestiona pestañas a la vez» viola el requisito de propósito único y no puede explicar claramente su uso al publicarse.
Lo correcto: una extensión resuelve una sola cosa. ¿Una segunda idea? Haz una segunda extensión.
Técnicas avanzadas (opcional)
🚀 La lista oficial de tutoriales es, tal cual, la ruta avanzada. Chrome oficial organizó para principiantes una cadena de tutoriales: Hello World → Run scripts on every page (añadir elementos automáticamente a sitios web concretos) → Inject scripts into the active tab (cambiar el estilo de la página actual al pulsar el icono de la barra de herramientas) → Create a tab manager (ventana emergente de gestión de pestañas) → Handle events with service workers → Debug your extension. Las últimas lecciones de la ruta C se desarrollan siguiendo esta cadena; al terminar las siete lecciones, tendrás la capacidad de completar después todos los tutoriales oficiales.
Si escribes extensiones con TypeScript, puedes instalar el paquete de npm chrome-types para obtener autocompletado de las Chrome API — este paquete se actualiza automáticamente con el código fuente de Chromium, así que recuerda actualizarlo con frecuencia.
Resumen de la lección
✅ En la primera lección de desarrollo de extensiones de navegador, has recibido este mapa:
- Extensión de navegador = mini programa que el navegador te permite oficialmente usar para transformarlo: personalizar la interfaz, escuchar eventos del navegador, modificar páginas web
- Cinco piezas de capacidades: ventana emergente de la barra de herramientas (Action), barra lateral, interceptar solicitudes (DeclarativeNetRequest), scripts de contenido, servicio en segundo plano
- Cero novedades en la pila tecnológica: HTML/CSS/JS + manifest.json; ahora solo se escribe MV3
- Tres líneas rojas de la publicación: propósito único, cumplir las políticas, empaquetar todo el código
- Siete lecciones de la ruta C: esta lección (los cimientos) → Hello World → manifest → doble script → depuración → publicación → estrategia de revisión
| Concepto clave | Memoria en una frase | En qué lección se desarrolla |
|---|---|---|
| manifest.json | El DNI + el manual de instrucciones de la extensión | C3 |
| MV3 | La única versión actual; no copies los tutoriales antiguos de MV2 | C2 |
| content script / service worker | Los brazos y piernas y el cerebro de la extensión | C4 |
| Carga local y depuración | chrome://extensions + ubicación de los registros | C5 |
| Publicación y revisión | Tarifa única de registro, la mayoría se revisa en 3 días | C6 · C7 |
Avance de la próxima lección
Próxima lección C2 Primera extensión de Chrome: Hello World funcionando en 15 minutos. Aprenderás:
- Cómo se ve el ejemplo mínimo funcional de manifest.json (el ejemplo oficial, palabra por palabra)
- Activar el modo de desarrollador en
chrome://extensionsy cargar localmente con Load unpacked en tres pasos - Tras modificar el código, qué archivos exigen recargar la extensión y cuáles no
- Cómo fijar (Pin) la extensión a la barra de herramientas para usarla cuando quieras
Cuando estés listo, entra en C2 →