Skip to main content

Informing browser providers about problems you encounter with your browser is an integral part of improving the web platform.


Updated

Presentar un buen error no es difícil, pero requiere un poco de trabajo. El objetivo es facilitar la búsqueda de lo que está roto, llegar a la causa raíz y, lo más importante, encontrar una manera de solucionarlo. Los errores que progresan rápidamente tienden a ser fáciles de reproducir con un comportamiento claro esperado.

Verify that it is an error

El primer paso es averiguar cuál debería ser el comportamiento «correcto».

¿Cuál es el comportamiento correcto?

See the relevant API docs at MDNo intente encontrar especificaciones relacionadas. Esta información puede ayudarlo a decidir qué API está realmente rota, dónde está rota y cuál es el comportamiento esperado.

¿Funciona en un navegador diferente?

El comportamiento que difiere entre los navegadores generalmente se prioriza más como un problema de interoperabilidad, especialmente cuando el navegador que contiene el error es el extraño. Intente probar en las últimas versiones de Chrome, Firefox, Safari y Edge, posiblemente usando una herramienta como BrowserStack.

Si es posible, verifique que la página no se comporte de manera intencional de manera diferente debido al rastreo del agente de usuario. En Chrome DevTools, intente configuring the User-Agent string to another browser.

¿Se rompió en un lanzamiento reciente?

¿Funcionó como se esperaba en el pasado, pero se rompió en una versión reciente del navegador? Se puede actuar sobre tales «regresiones» mucho más rápido, especialmente si proporciona un número de versión donde funcionó y una versión donde falló. Herramientas como
BrowserStack puede facilitar la comprobación de versiones antiguas del navegador.

Si un problema es una regresión y se puede reproducir, la causa raíz generalmente se puede encontrar y solucionar rápidamente.

¿Otros están viendo el mismo problema?

Si tiene problemas, es muy probable que otros desarrolladores también lo estén. Primero, intente buscar el error en Stack overflow. Esto podría ayudarlo a traducir un problema abstracto en una API rota específica y podría ayudarlo a encontrar una solución a corto plazo hasta que se solucione el error.

¿Se ha informado antes?

Una vez que tenga una idea de cuál es el error, es hora de verificar si el error ya ha sido informado buscando en la base de datos de errores del navegador.

If you find an existing bug that describes the problem, please add your support by highlighting, bookmarking, or commenting on the bug. And on many sites, you can add yourself to the CC list and get updates when the error changes.

Si decide comentar sobre el error, incluya información sobre cómo el error afecta su sitio web. Evite agregar comentarios de estilo «+1», ya que los rastreadores de errores suelen enviar correos electrónicos por cada comentario.

Report the bug

If the error has not been reported before, it is time to inform the browser provider.

Create a minimized test case

Mozilla tiene un gran artículo sobre
cómo crear un caso de prueba minimizado. Para abreviar la historia, aunque una descripción del problema es un gran comienzo, nada mejor que proporcionar una demostración vinculada en el error que muestra el problema. Para maximizar la posibilidad de un progreso rápido, el ejemplo debe contener el código mínimo posible necesario para demostrar el problema. Una muestra de código mínima es lo primero que puede hacer para aumentar las probabilidades de que su error se solucione.

A continuación, se ofrecen algunos consejos para minimizar un caso de prueba:

  • Descargue la página web, agregue

    and verify that the error exists locally. This may require an active HTTPS server if the URL uses HTTPS.

  • Pruebe los archivos locales en las últimas versiones de tantos navegadores como pueda.
  • Try to condense everything into 1 file.
  • Elimine el código (comenzando con cosas que sabe que son innecesarias) hasta que desaparezca el error.
  • Use version control so you can save your work and undo the things that went wrong.

Host a minified test case

Si está buscando un buen lugar para alojar su caso de prueba minificado, hay varios buenos lugares disponibles:

Note that several of those sites display content in an iframe, which can cause functions or errors to behave differently.

Present your problem

Una vez que tenga su caso de prueba minimizado, estará listo para presentar ese error. Dirígete al sitio de seguimiento de errores correcto y crea un nuevo problema.

Proporcione una descripción clara y los pasos necesarios para reproducir el problema.

Primero, proporcione una descripción clara para ayudar a los ingenieros a comprender rápidamente cuál es el problema y ayudar a clasificar el problema.

When installing a PWA using the `beforeinstallprompt.prompt ()`, the
`appinstalled` event fires before the call to` prompt () `resolves.

A continuación, proporcione los pasos detallados necesarios para reproducir el problema. Aquí es donde entra su caso de prueba minificado.

What steps will reproduce the problem?
1. Go to https://basic-pwa.glitch.me/, open DevTools and look at the
console tab.
2. Click the Install button in the page, you might need to interact with
the page a bit before it becomes enabled.
3. Click Install on the browser modal install confirmation.

And finally, describe the realand expected result.

What is the actual result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL: Success (logged when `appinstalled` event fired)
2. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
(logged when beforeinstallprompt.prompt () `resolves)

What is the expected result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
(logged when beforeinstallprompt.prompt () `resolves)
2. INSTALL: Success (logged when `appinstalled` event fired)

Para obtener más información, consulte Directrices para la redacción de informes de errores
in MDN.

Bonificación: agregue una captura de pantalla o un screencast del problema

Aunque no es obligatorio, en algunos casos puede ser útil agregar una captura de pantalla o un screencast del problema. Esto es especialmente útil en los casos en que los errores pueden requerir algunos pasos extraños para reproducirse. Con frecuencia, puede ser útil poder ver lo que sucede en un screencast o en una captura de pantalla.

Include environmental details

Algunos errores son reproducibles solo en ciertos sistemas operativos, o solo en tipos específicos de pantallas (por ejemplo, ppp bajos o altos). Asegúrese de incluir los detalles de los entornos de prueba que utilizó.

Envíe el error

Finalmente, envíe el error. Luego, recuerde estar atento a su correo electrónico para ver las respuestas al error. Por lo general, durante la investigación y al corregir el error, los ingenieros pueden tener preguntas adicionales o, si tienen dificultades para reproducir el problema, pueden comunicarse.