Informar a los proveedores de navegadores sobre los problemas que encuentre en su navegador es una parte integral para mejorar la plataforma web.
Actualizado
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.
Verifica que sea un error
El primer paso es averiguar cuál debería ser el comportamiento «correcto».
¿Cuál es el comportamiento correcto?
Consulte los documentos de API relevantes en 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 configurando el User-Agent cadena a otro navegador.
¿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 Desbordamiento de pila. 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.
Si encuentra un error existente que describe el problema, agregue su apoyo destacando, marcando como favorito o comentando el error. Y, en muchos sitios, puede agregarse a la lista CC y obtener actualizaciones cuando cambie el error.
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.
Informar el error
Si el error no se ha informado antes, es hora de informarle al proveedor del navegador.
Cree un caso de prueba minimizado
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
<base href="https://original.url">y verifique que el error exista localmente. Esto puede requerir un servidor HTTPS activo si la URL usa HTTPS.
- Pruebe los archivos locales en las últimas versiones de tantos navegadores como pueda.
- Intente condensar todo en 1 archivo.
- Elimine el código (comenzando con cosas que sabe que son innecesarias) hasta que desaparezca el error.
- Use el control de versiones para que pueda guardar su trabajo y deshacer las cosas que salieron mal.
Alojar un caso de prueba minificado
Si está buscando un buen lugar para alojar su caso de prueba minificado, hay varios buenos lugares disponibles:
Tenga en cuenta que varios de esos sitios muestran contenido en un iframe, lo que puede provocar que las funciones o los errores se comporten de manera diferente.
Presentar su problema
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.Y finalmente, describe el realy esperado resultado.
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
en 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.
Incluir detalles del medio ambiente
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.
