necisito guardar informacion en una extension en firefox, como hago para guardar tanto…
- User
necisito guardar informacion en una extension en firefox, como hago para guardar tanto en un content script como en el popup
Assistant
¡Claro! Para guardar información en una extensión de Firefox, tanto desde un content script como desde el popup, la forma recomendada es usar la API
browser.storage. Esta API te permite almacenar datos de forma persistente.Tienes dos áreas principales de almacenamiento:
-
browser.storage.local:- Los datos se almacenan localmente en la máquina del usuario.
- No se sincronizan entre dispositivos.
- Ideal para configuraciones específicas del navegador o datos más grandes.
- Límites de almacenamiento más generosos (por defecto 5MB, pero puede ser más).
-
browser.storage.sync:- Los datos se sincronizan automáticamente a través de Firefox Sync si el usuario lo tiene habilitado y ha iniciado sesión.
- Ideal para preferencias del usuario que deberían estar disponibles en todos sus dispositivos.
- Tiene límites de almacenamiento más estrictos (alrededor de 100KB en total, y ~8KB por ítem) y límites en la frecuencia de escritura.
Ambos
content scriptsypopup scripts(y tambiénbackground scripts) pueden acceder directamente abrowser.storage.Pasos Generales:
-
Declarar el permiso en
manifest.json: Necesitas el permiso"storage"en tu archivomanifest.json.{ "manifest_version": 2, // o 3 "name": "Mi Extension de Almacenamiento", "version": "1.0", "description": "Ejemplo de cómo guardar datos.", "permissions": [ "storage", "activeTab" // Si tu content script lo necesita ], "browser_action": { // Para Manifest V2 "default_popup": "popup.html", "default_icon": "icon.png" }, "action": { // Para Manifest V3 "default_popup": "popup.html", "default_icon": "icon.png" }, "content_scripts": [ { "matches": ["<all_urls>"], // o URLs específicas "js": ["content.js"] } ] } -
Guardar Datos: Usa
browser.storage.local.set()obrowser.storage.sync.set(). Estas funciones son asíncronas y devuelven una Promesa. -
Leer Datos: Usa
browser.storage.local.get()obrowser.storage.sync.get(). También son asíncronas. -
Escuchar Cambios (Opcional pero útil): Puedes usar
browser.storage.onChanged.addListener()para reaccionar cuando los datos en el almacenamiento cambian. Esto es muy útil para que el popup se actualice si un content script modifica los datos, o viceversa.
Ejemplo Práctico:
Vamos a crear un ejemplo donde el content script guarda la URL actual y el popup la muestra. Luego, el popup permitirá guardar una nota que el content script podría (hipotéticamente) usar.
1.
manifest.json(ya mostrado arriba, asegúrate de tenerlo)2.
popup.html:<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Popup de Almacenamiento</title> <style> body { font-family: sans-serif; width: 250px; padding: 10px; } label { display: block; margin-bottom: 5px; } input, textarea { width: 95%; margin-bottom: 10px; } button { padding: 8px; } </style> </head> <body> <h3>Información Guardada</h3> <p><strong>Última URL visitada:</strong> <span id="lastUrl">Cargando...</span></p> <hr> <label for="userNote">Tu Nota:</label> <textarea id="userNote" rows="3"></textarea> <button id="saveNoteBtn">Guardar Nota</button> <p id="status"></p> <script src="popup.js"></script> </body> </html>3.
popup.js:const lastUrlElement = document.getElementById('lastUrl'); const userNoteElement = document.getElementById('userNote'); const saveNoteBtn = document.getElementById('saveNoteBtn'); const statusElement = document.getElementById('status'); // Función para cargar datos cuando se abre el popup async function loadData() { try { const data = await browser.storage.local.get(['lastVisitedUrl', 'userNote']); if (data.lastVisitedUrl) { lastUrlElement.textContent = data.lastVisitedUrl; } else { lastUrlElement.textContent = 'Ninguna URL guardada aún.'; } if (data.userNote) { userNoteElement.value = data.userNote; } } catch (error) { console.error("Error al cargar datos:", error); lastUrlElement.textContent = 'Error al cargar.'; statusElement.textContent = 'Error al cargar datos.'; } } // Guardar la nota desde el popup saveNoteBtn.addEventListener('click', async () => { const note = userNoteElement.value; try { await browser.storage.local.set({ userNote: note }); statusElement.textContent = 'Nota guardada!'; setTimeout(() => statusElement.textContent = '', 2000); console.log("Nota guardada desde el popup:", note); } catch (error) { console.error("Error al guardar nota:", error); statusElement.textContent = 'Error al guardar nota.'; } }); // Escuchar cambios en el almacenamiento (por ejemplo, si el content script guarda algo) browser.storage.onChanged.addListener((changes, areaName) => { if (areaName === 'local') { if (changes.lastVisitedUrl) { lastUrlElement.textContent = changes.lastVisitedUrl.newValue || 'Ninguna URL guardada aún.'; console.log("Popup: lastVisitedUrl cambió a", changes.lastVisitedUrl.newValue); } if (changes.userNote && changes.userNote.newValue !== userNoteElement.value) { // Si la nota cambió por otra fuente y es diferente a la que está en el textarea userNoteElement.value = changes.userNote.newValue || ''; console.log("Popup: userNote cambió a", changes.userNote.newValue); } } }); // Cargar datos al iniciar document.addEventListener('DOMContentLoaded', loadData);4.
content.js:console.log("Content script cargado en:", window.location.href); // Guardar la URL actual cuando se carga la página async function saveCurrentUrl() { try { await browser.storage.local.set({ lastVisitedUrl: window.location.href }); console.log("Content Script: URL guardada:", window.location.href); } catch (error) { console.error("Content Script: Error al guardar URL:", error); } } // Leer la nota guardada (quizás para mostrarla en la página o actuar sobre ella) async function checkUserNote() { try { const data = await browser.storage.local.get('userNote'); if (data.userNote) { console.log("Content Script: Nota leída del almacenamiento:", data.userNote); // Aquí podrías hacer algo con la nota, por ejemplo, mostrar un alert // alert("Nota recordatorio: " + data.userNote); } } catch (error) { console.error("Content Script: Error al leer nota:", error); } } // Ejecutar las funciones saveCurrentUrl(); checkUserNote(); // Llamar para verificar la nota al cargar // También podrías escuchar cambios si el content script necesita reaccionar // a cambios hechos por el popup u otro content script. browser.storage.onChanged.addListener((changes, areaName) => { if (areaName === 'local' && changes.userNote) { console.log("Content Script: La nota cambió a:", changes.userNote.newValue); // Reaccionar al cambio de nota si es necesario } });Cómo funciona:
content.js: Cuando visitas una página, el content script se inyecta, obtiene la URL actual (window.location.href) y la guarda enbrowser.storage.localbajo la clavelastVisitedUrl. También intenta leer cualquieruserNote.popup.js:- Cuando abres el popup,
loadDatase ejecuta y recuperalastVisitedUrlyuserNotedebrowser.storage.localpara mostrarlo. - Si escribes algo en el
textareay haces clic en "Guardar Nota", esa nota se guarda enbrowser.storage.localbajo la claveuserNote.
- Cuando abres el popup,
browser.storage.onChanged.addListener:- Tanto el
popup.jscomo elcontent.jsestán escuchando cambios. - Si el content script actualiza
lastVisitedUrl, el listener en el popup (si está abierto) lo detectará y actualizará el texto. - Si el popup guarda una
userNote, el listener en elcontent.js(en todas las pestañas donde esté activo) lo detectará.
- Tanto el
Para probar:
- Guarda los archivos (
manifest.json,popup.html,popup.js,content.jsy unicon.pngsi quieres). - Abre Firefox, ve a
about:debugging. - Haz clic en "Esta Firefox" (o "This Firefox").
- Haz clic en "Cargar complemento temporal..." y selecciona el archivo
manifest.json. - Navega a cualquier página web. El content script guardará la URL.
- Abre el popup haciendo clic en el icono de la extensión. Deberías ver la URL de la página actual.
- Escribe una nota en el popup y guárdala.
- Revisa la consola del content script (Herramientas para desarrolladores > Consola, y asegúrate de seleccionar el contexto del content script en el selector de iframes/contextos) y la consola del popup (haz clic derecho en el popup > Inspeccionar elemento). Verás los mensajes de log.
Esta es la forma estándar y robusta de manejar el almacenamiento compartido entre diferentes partes de tu extensión. Recuerda usar
async/awaito manejar las Promesas devueltas por las funciones debrowser.storagecorrectamente.-
- User
y donde lo puedo ver en las herramientas de depuracion
Assistant
¡Excelente pregunta! Ver los datos guardados con
browser.storagedirectamente en una pestaña "Almacenamiento" de las herramientas de desarrollo (como lo harías conlocalStoragede una página web) no es tan directo, pero puedes inspeccionarlos fácilmente desde la consola de las diferentes partes de tu extensión.Aquí te explico cómo:
-
Desde la Consola del Script de Fondo (Background Script):
- Ve a
about:debugging#/runtime/this-firefox. - Busca tu extensión en la lista.
- Haz clic en el botón "Inspeccionar" (o "Inspect") al lado del nombre de tu extensión. Esto abrirá una ventana de Herramientas de Desarrollo específicamente para el script de fondo de tu extensión.
- En la pestaña "Consola" de esa ventana, puedes ejecutar comandos para ver el almacenamiento:
- Para ver todo en
browser.storage.local:browser.storage.local.get(null).then(data => { console.log("Datos en browser.storage.local:", data); }); - Para ver todo en
browser.storage.sync:browser.storage.sync.get(null).then(data => { console.log("Datos en browser.storage.sync:", data); }); - Para ver una clave específica (por ejemplo,
userNote):browser.storage.local.get('userNote').then(data => { console.log("Nota del usuario:", data.userNote); });
- Para ver todo en
- Ve a
-
Desde la Consola del Popup:
- Abre el popup de tu extensión haciendo clic en su icono.
- Haz clic derecho dentro del popup y selecciona "Inspeccionar elemento" (o "Inspect Element"). Esto abrirá una ventana de Herramientas de Desarrollo para el HTML y JavaScript del popup.
- En la pestaña "Consola", puedes ejecutar los mismos comandos que arriba:
browser.storage.local.get(null).then(console.log); // o para una clave específica browser.storage.local.get('lastVisitedUrl').then(console.log);
-
Desde la Consola del Content Script:
- Abre las Herramientas de Desarrollo para la página web donde tu content script está inyectado (puedes presionar F12 o clic derecho en la página -> "Inspeccionar elemento").
- En la pestaña "Consola", asegúrate de que el contexto de ejecución esté configurado para tu content script. A veces, hay un menú desplegable en la parte superior de la consola (junto al icono del cursor o un icono de engranaje/filtro) que te permite cambiar el contexto de
top(la página principal) al de tu extensión (suele aparecer con el nombre de tu extensión o un ID). Si no ves esta opción, los comandos generalmente se ejecutan en el contexto correcto si tu content script está activo en esa página. - Ejecuta los mismos comandos:
browser.storage.local.get(null).then(data => { console.log("Datos locales vistos desde content script:", data); });
Herramienta Adicional (Extensión para inspeccionar almacenamiento de extensiones):
Existe una extensión muy útil llamada "Extension Storage Inspector" (o similares) que puedes instalar en Firefox. Una vez instalada, te proporciona una interfaz gráfica para ver y, a veces, editar los datos almacenados por otras extensiones usando
browser.storage.localybrowser.storage.sync.- Busca "Extension Storage Inspector" en el sitio de Complementos de Firefox (addons.mozilla.org).
- Después de instalarla, generalmente añade un nuevo panel a las Herramientas de Desarrollo (F12) o un botón en su propia barra de herramientas.
En resumen:
- Método principal: Usa
browser.storage.local.get(null).then(console.log);(o.sync.) en la consola del contexto que quieras inspeccionar (background, popup, content script). - Alternativa GUI: Instala una extensión como "Extension Storage Inspector" para una vista más amigable.
El método de la consola es el más directo y siempre disponible sin necesidad de instalar nada extra. El
nullenget(null)le dice a la API que quieres obtener todos los elementos almacenados.-
- User
el ejemplo mas sencillo que halla
Assistant
¡Entendido! Aquí tienes el ejemplo más sencillo posible para ilustrar cómo guardar y leer desde el content script y el popup usando
browser.storage.local.1.
manifest.json{ "manifest_version": 2, "name": "Demo Almacenamiento Simple", "version": "1.0", "description": "Guarda y lee datos simples.", "permissions": [ "storage", // Permiso para usar browser.storage "<all_urls>" // Para que el content script se ejecute en todas las páginas ], "browser_action": { "default_popup": "popup.html" // El HTML para el popup }, "content_scripts": [ { "matches": ["<all_urls>"], "js": ["content.js"] // El script que se inyecta en las páginas } ] }2.
popup.html(Interfaz del Popup)<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Popup</title> <style>body { width: 200px; padding: 10px; font-family: sans-serif; }</style> </head> <body> <h4>Datos de la Extensión</h4> <p> Mensaje del Content: <br> <strong id="msgFromContent">Cargando...</strong> </p> <hr> <label for="popupData">Guardar desde Popup:</label> <input type="text" id="popupData" style="width: 90%;"> <button id="saveBtn">Guardar</button> <p id="statusPopup"></p> <script src="popup.js"></script> </body> </html>3.
popup.js(Lógica del Popup)const msgFromContentElement = document.getElementById('msgFromContent'); const popupDataInput = document.getElementById('popupData'); const saveBtn = document.getElementById('saveBtn'); const statusPopupElement = document.getElementById('statusPopup'); // Al abrir el popup, leer lo que guardó el content script browser.storage.local.get('datoDelContentScript') .then((result) => { if (result.datoDelContentScript) { msgFromContentElement.textContent = result.datoDelContentScript; } else { msgFromContentElement.textContent = "Nada aún."; } }) .catch(error => console.error("Popup: Error al leer del content:", error)); // Cuando se hace clic en el botón "Guardar" del popup saveBtn.addEventListener('click', () => { const valor = popupDataInput.value; browser.storage.local.set({ datoDelPopup: valor }) .then(() => { console.log('Popup: Dato guardado:', valor); statusPopupElement.textContent = '¡Guardado!'; popupDataInput.value = ''; // Limpiar input setTimeout(() => statusPopupElement.textContent = '', 2000); }) .catch(error => console.error("Popup: Error al guardar:", error)); }); // Opcional: Escuchar si el content script actualiza su dato browser.storage.onChanged.addListener((changes, areaName) => { if (areaName === 'local' && changes.datoDelContentScript) { msgFromContentElement.textContent = changes.datoDelContentScript.newValue || "Nada aún."; console.log("Popup: 'datoDelContentScript' cambió a:", changes.datoDelContentScript.newValue); } });4.
content.js(Lógica del Content Script)// 1. Guardar algo desde el content script cuando la página carga const mensajeContent = "Hola desde el Content Script! URL: " + window.location.hostname; browser.storage.local.set({ datoDelContentScript: mensajeContent }) .then(() => { console.log('Content Script: Dato guardado:', mensajeContent); }) .catch(error => console.error("Content Script: Error al guardar:", error)); // 2. Leer (y loguear) algo que el popup podría haber guardado function leerDatoDelPopup() { browser.storage.local.get('datoDelPopup') .then((result) => { if (result.datoDelPopup) { console.log('Content Script: Leído del popup ->', result.datoDelPopup); // Aquí podrías hacer algo en la página con result.datoDelPopup } else { console.log('Content Script: No hay "datoDelPopup" aún.'); } }) .catch(error => console.error("Content Script: Error al leer del popup:", error)); } // Llamar para verificar al cargar leerDatoDelPopup(); // Opcional: Escuchar si el popup actualiza su dato browser.storage.onChanged.addListener((changes, areaName) => { if (areaName === 'local' && changes.datoDelPopup) { console.log("Content Script: 'datoDelPopup' cambió a:", changes.datoDelPopup.newValue); // Aquí podrías reaccionar al cambio } });Funcionamiento:
-
Content Script (
content.js):- Cuando visitas cualquier página web, este script se inyecta.
- Guarda un mensaje (que incluye el hostname de la página actual) en
browser.storage.localcon la clavedatoDelContentScript. - Intenta leer cualquier dato guardado por el popup con la clave
datoDelPopupy lo muestra en la consola del content script.
-
Popup (
popup.htmlypopup.js):- Cuando haces clic en el icono de la extensión, se abre el popup.
popup.jsintenta leer eldatoDelContentScriptdebrowser.storage.localy lo muestra.- Puedes escribir algo en el campo de texto del popup y hacer clic en "Guardar". Esto guardará tu texto en
browser.storage.localcon la clavedatoDelPopup.
Para Probar:
- Crea una carpeta, y guarda estos 4 archivos dentro.
- Abre Firefox, ve a
about:debugging. - Haz clic en "Esta Firefox" -> "Cargar complemento temporal...".
- Selecciona el archivo
manifest.jsonde tu carpeta. - Navega a cualquier página web (por ejemplo,
google.com).- Abre las herramientas de desarrollador (F12), ve a la consola y busca los mensajes del "Content Script". Verás que guardó su mensaje.
- Haz clic en el icono de tu extensión (debería aparecer en la barra de herramientas).
- El popup mostrará el mensaje que el content script guardó.
- Escribe algo en el campo del popup (ej: "Mensaje desde Popup") y haz clic en "Guardar".
- Vuelve a la consola del content script en la página web. Si tenías la consola abierta, deberías ver que el
onChangedlistener (o si recargas la página, la funciónleerDatoDelPopup) detecta el mensaje que guardaste desde el popup.
Este ejemplo usa
browser.storage.local.set()para guardar ybrowser.storage.local.get()para leer, que son las operaciones fundamentales. También incluyebrowser.storage.onChanged.addListenercomo una forma útil (pero opcional para lo más básico) de que las diferentes partes reaccionen a los cambios en el almacenamiento.-
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.