Skip to content

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.

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 oficialen lenguaje llano
1customizing the user interfaceañadir tu propia interfaz al navegador (botones, ventanas emergentes, barra lateral)
2observing browser eventsescuchar cada acción del navegador (abrir pestañas, cerrar pestañas, borrar marcadores)
3modifying the webmodificar 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.

CapacidadDescripción oficialUso 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 navegadorDiccionario permanente, notas, barra de chat de IA
Intercepción de peticiones de red (DeclarativeNetRequest)Intercepta, bloquea o modifica peticiones de redFiltro de anuncios, bloqueo de scripts de rastreo
Content scripts (scripts de contenido)Ejecuta JavaScript en el entorno de la página webAñ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íaEn páginas web (ruta A)En extensiones
HTMLEstructura de la páginaEstructura de página de popups, panel lateral y página de ajustes
CSSEstilos de la páginaLa misma forma de escribirlo
JavaScriptLógica de la páginaEl 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:

  1. 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
  2. Cumplir las políticas del programa para desarrolladores (developer program policies): hay normas para el contenido, el comportamiento y la privacidad
  3. 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ónQué resuelve
C2 Tu primera extensión de ChromeHacer funcionar un Hello World en 15 minutos: ejemplo mínimo de manifest + tres pasos de carga local
C3 manifest.json a fondoQué significa cada campo y qué más hay que rellenar para publicar
C4 Content Script y Service WorkerQué 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 funcionaDónde encontrar los logs y cómo leer los errores
C6 Publicar en la Chrome Web StoreRegistro 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ónRevisió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 claveMemoria en una fraseEn qué lección se desarrolla
manifest.jsonEl DNI + el manual de instrucciones de la extensiónC3
MV3La única versión actual; no copies los tutoriales antiguos de MV2C2
content script / service workerLos brazos y piernas y el cerebro de la extensiónC4
Carga local y depuraciónchrome://extensions + ubicación de los registrosC5
Publicación y revisiónTarifa única de registro, la mayoría se revisa en 3 díasC6 · 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://extensions y 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 →

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.