Pruebas automatizadas de Mozilla

  • Enlace amigable (slug) de la revisión: Pruebas_automatizadas_de_Mozilla
  • Título de la revisión: Pruebas automatizadas de Mozilla
  • Id de la revisión: 123933
  • Creada:
  • Creador: RickieesES
  • ¿Es la revisión actual? No
  • Comentario Esta página no debe autolesionarse ;-)

Contenido de la revisión

Esta página proporciona un compendio de opciones para pruebas automatizadas disponibles para los desarrolladores de Mozilla.

La mayoría de las pruebas automatizadas deberían ejecutarse sobre make check. Cómo añadir una prueba en el momento de compilar describe los pasos requeridos para añadir un programa de pruebas arbitrario al conjunto de tests. Dependiendo de lo que se necesite probar, puede usarse uno de los siguientes frameworks disponibles:

Pruebas unitarias

xpcshell: make check

Con las ayudas para pruebas de xpcshell escribes pruebas unitarias en JavaScript. El código se ejecutará más tarde en xpcshell, que es una consola JS con capacidad para XPConnect. Esto significa que tu código puede acceder a componentes XPCOM, pero no puede (fácilmente) abrir ventanas, probar el chrome de la aplicación, trabajar con el analizador HTML o usar DOM.

Hay disponible un servidor HTTP sencillo para su uso desde los tests xpcshell.

Pruebas mediante código compilado

Las funcionalidades no susceptibles de ser usadas en scripts y otras similares requieren que se escriban pruebas en C++ para ejecutar la funcionalidad. A pesar de las apariencias, existen muy pocas pruebas de esta naturaleza en el repositorio en este momento. Aunque en realidad hay muchas pruebas así (mira los contenidos de {{ Source("xpcom/tests") }} para ver muchos ejemplos), muchas de ellas sólo pueden ejecutarse manualmente, la mayoría devuelven fallos usando mensajes personalizados directamente a la consola (y, por tanto, no se puede revisar automáticamente si se han ejecutado correctamente), y muchas no se compilan correctamente o contienen numerosos errores.

A pesar de todo ello, se han escrito algunas pruebas en C++ que pueden ser ejecutadas automáticamente detectando los fallos. El mejor ejemplo actual en términos de facilidad de autoría es {{ Source("xpcom/tests/TestPipe.cpp") }}, que usa una cabecera especial de apoyo a pruebas dirigida a facilitar la escritura de tales pruebas. Mira Compiled-code automated tests para obtener detalles.

Escribir una prueba en C++ es más difícil que escribir una prueba en xpcshell, y el código es más difícil de mantener y modificar. ¡No escribas pruebas en código compilado si no es necesario! Deberías usar estas pruebas únicamente cuando la funcionalidad a probar depende de interfaces, métodos o propiedades que no se pueden llamar desde scripts.

Pruebas gráficas y/o interactivas

Mochitest

Mochitest es un framework basado en Mochikit para escribir pruebas. Las pruebas se ejecutan en el navegador, desde un servidor web local (proporcionado por Mochitest). Los scripts de inicio que lo acompañan conceden diversos privilegios a localhost (crea un nuevo perfil en cada ejecución). Como resultado, las pruebas unitarias son libres de solicitar privilegios UniversalXPConnect (acceso a componentes XPCOM), abrir ventanas emergentes, etc. Mochitest es una buena solución si realmente necesitas un navegador completo para probar un problema. Por ejemplo, un test reciente verifica que el envío de formularios funciona en iframes fijados a display:none. Hay una FAQ de Mochitest.

Pruebas chrome del navegador

Las pruebas chrome del navegador están pensadas para usarse probando el código "chrome" de la interfaz, y otras características susceptibles de ser probadas desde el código JavaScript de chrome. Consisten en pequeños bloques de código JavaScript que se ejecutan en el ámbito de la ventana del navegador.

Reftest

{{ Source("layout/tools/reftest/README.txt", "Tests visuales del motor de dibujado (reftest)") }}. Cada test consiste normalmente en dos archivos - uno de ellos contiene un conjunto de etiquetas de prueba y el otro normalmente contiene un conjunto de etiquetas de referencia (aunque también es posible usar un PNG estático si se desea). El sistema trabaja comparando el renderizado de los dos archivos.

reftest se compila e instala ahora automáticamente cuando ENABLE_TESTS está activado (valor predeterminado) y hay pruebas de ejemplo en {{ Source("layout/reftests") }}.

Para ejecutar todos estos tests, escribe:

obj-debug/dist/MinefieldDebug.app/Contents/MacOS/firefox -reftest layout/reftests/reftest.list

(Se supone que "make lcheck" debe hacer esto por ti, pero actualmente no funciona).

Puedes buscar entre los resultados (usando "grep") la cadena "UNEXPECTED" o ejecutar una de las herramientas de procesado de salida de reftest listadas en el README.

Puede que quieras usar un perfil separado para ejecutar los tests (creando un perfil llamado "reftests" y añadiendo -P reftests a la línea que invoca la aplicación).

Para más información, acude a {{ Source("layout/tools/reftest/README.txt", "") }} y el tutorial sobre cómo crear un test basado en reftest.

Crash tests

El framework para pruebas de fallos está basado en el framework reftest, por lo que escribir y ejecutar pruebas es muy parecido. Cada test es un solo archivo y la prueba funciona cargando el archivo y ejecutándolo sin detener el programa ni lanzar aserciones (el framework no vigila explícitamente las aserciones en este momento, necesitarás hacer grep para localizarlas en la salida).

Para ejecutar todas las pruebas de fallos, escribe

obj-debug/dist/MinefieldDebug.app/Contents/MacOS/firefox -reftest testing/crashtest/crashtests.list

Otra documentación de referencia

Por favor, ignora la página {{ mediawiki.interwiki('wikimo', 'SoftwareTesting:Scratchpad', 'wikimo:SoftwareTesting:Scratchpad') }}, y mira únicamente {{ mediawiki.interwiki('wikimo', 'SoftwareTesting', 'wikimo:SoftwareTesting') }}. La pizarra (Scratchpad) es para trabajos en curso, y casi con toda seguridad estará obsoleta o tendrá documentación errónea.

También está {{ mediawiki.interwiki('wikimo', 'SoftwareTesting', 'wikimo:SoftwareTesting') }} y Consejos y trucos para pruebas automatizadas si estás buscando algo que leer.

Estos otros esfuerzos están en curso:

  • Puedes escribir programas de prueba independientes en C/C++. Esta opción puede usarse para probar funcionalidades no expuestas a través de XPCOM.
    • {{ Bug("343673") }} registra el trabajo de una persona, y parece que ha habido ciertos progresos.
    • {{ Bug("346703") }} contiene un ejemplo de cómo puede hacerse esto.
  • JSUnit puede usarse para escribir pruebas que se ejecutan como contenido en el navegador. Es especialmente útil para tests DOM y del analizador sintáctico, pero no puede hacer nada que requiera privilegios chrome.
    • JsUnit probablemente no pueda usarse como un objetivo de compilación para make check de momento, ya que necesita una instancia completa de un navegador.
    • {{ mediawiki.interwiki('wikimo', 'SoftwareTesting#Ideas to Collect', 'wikimo:SoftwareTesting#Ideas_to_Collect') }} lista algunos ejemplos de jsunit.
    • Remítete a la documentación en {{ mediawiki.interwiki('wikimo', 'SoftwareTesting:Tools:jsUnit', 'wikimo:SoftwareTesting:Tools:jsUnit') }} para más información.
    • Algunos tests de XForms usan JsUnit, a modo de ejemplo.

Utilidades y frameworks existentes para pruebas

(originalmente de {{ mediawiki.interwiki('wikimo', 'SoftwareTesting:Catalog_of_Automated_Tests', 'wikimo:SoftwareTesting:Catalog_of_Automated_Tests') }})

{{ languages( { "en": "en/Mozilla_automated_testing" } ) }}

Fuente de la revisión

<p>
</p><p>Esta página proporciona un compendio de opciones para pruebas automatizadas disponibles para los desarrolladores de Mozilla.
</p><p>La mayoría de las pruebas automatizadas deberían ejecutarse sobre <code>make check</code>. <a href="es/C%c3%b3mo_a%c3%b1adir_una_prueba_en_el_momento_de_compilar">Cómo añadir una prueba en el momento de compilar</a> describe los pasos requeridos para añadir un programa de pruebas arbitrario al conjunto de tests. Dependiendo de lo que se necesite probar, puede usarse uno de los siguientes <i>frameworks</i> disponibles:
</p>
<h3 name="Pruebas_unitarias"> Pruebas unitarias </h3>
<h4 name="xpcshell:_make_check"> xpcshell: make check </h4>
<p>Con <a href="es/Escribir_pruebas_unitarias_basadas_en_xpcshell">las ayudas para pruebas de xpcshell</a> escribes pruebas unitarias en JavaScript. El código se ejecutará más tarde en <a href="es/Xpcshell">xpcshell</a>, que es una consola JS con capacidad para <a href="es/XPConnect">XPConnect</a>. Esto significa que tu código puede acceder a componentes XPCOM, pero no puede (fácilmente) abrir ventanas, probar el chrome de la aplicación, trabajar con el analizador HTML o usar DOM.
</p><p>Hay disponible un <a href="es/Servidor_HTTP_para_pruebas_unitarias">servidor HTTP</a> sencillo para su uso desde los tests xpcshell.
</p>
<h4 name="Pruebas_mediante_c.C3.B3digo_compilado"> Pruebas mediante código compilado </h4>
<p>Las funcionalidades no susceptibles de ser usadas en scripts y otras similares requieren que se escriban pruebas en C++ para ejecutar la funcionalidad. A pesar de las apariencias, existen muy pocas pruebas de esta naturaleza en el repositorio en este momento. Aunque en realidad hay muchas pruebas así (mira los contenidos de {{ Source("xpcom/tests") }} para ver muchos ejemplos), muchas de ellas sólo pueden ejecutarse manualmente, la mayoría devuelven fallos usando mensajes personalizados directamente a la consola (y, por tanto, no se puede revisar automáticamente si se han ejecutado correctamente), y muchas no se compilan correctamente o contienen numerosos errores.
</p><p>A pesar de todo ello, se han escrito algunas pruebas en C++ que pueden ser ejecutadas automáticamente detectando los fallos. El mejor ejemplo actual en términos de facilidad de autoría es {{ Source("xpcom/tests/TestPipe.cpp") }}, que usa una cabecera especial de apoyo a pruebas dirigida a facilitar la escritura de tales pruebas. Mira <a href="es/Compiled-code_automated_tests">Compiled-code automated tests</a> para obtener detalles.
</p><p>Escribir una prueba en C++ es más difícil que escribir una prueba en xpcshell, y el código es más difícil de mantener y modificar. <b>¡No escribas pruebas en código compilado si no es necesario!</b> Deberías usar estas pruebas únicamente cuando la funcionalidad a probar depende de interfaces, métodos o propiedades que no se pueden llamar desde scripts.
</p>
<h3 name="Pruebas_gr.C3.A1ficas_y.2Fo_interactivas"> Pruebas gráficas y/o interactivas </h3>
<h4 name="Mochitest"> Mochitest </h4>
<p><a href="es/Mochitest">Mochitest</a> es un <i>framework</i> basado en <a class="external" href="http://mochikit.com/">Mochikit</a> para escribir pruebas. Las pruebas se ejecutan en el navegador, desde un servidor web local (proporcionado por Mochitest). Los <i>scripts</i> de inicio que lo acompañan conceden diversos privilegios a localhost (crea un nuevo perfil en cada ejecución). Como resultado, las pruebas unitarias son libres de solicitar privilegios UniversalXPConnect (acceso a componentes XPCOM), abrir ventanas emergentes, etc. Mochitest es una buena solución si realmente necesitas un navegador completo para probar un problema. Por ejemplo, un test reciente verifica que el envío de formularios funciona en iframes fijados a <code>display:none</code>. Hay una <a href="es/Mochitest#FAQ">FAQ de Mochitest</a>.
</p>
<h4 name="Pruebas_chrome_del_navegador"> Pruebas chrome del navegador </h4>
<p>Las <a href="es/Pruebas_chrome_del_navegador">pruebas chrome del navegador</a> están pensadas para usarse probando el código "chrome" de la interfaz, y otras características susceptibles de ser probadas desde el código JavaScript de chrome. Consisten en pequeños bloques de código JavaScript que se ejecutan en el ámbito de la ventana del navegador.
</p>
<h4 name="Reftest"> Reftest </h4>
<p>{{ Source("layout/tools/reftest/README.txt", "Tests visuales del motor de dibujado (reftest)") }}. Cada test consiste normalmente en dos archivos - uno de ellos contiene un conjunto de etiquetas de prueba y el otro normalmente contiene un conjunto de etiquetas de referencia (aunque también es posible usar un PNG estático si se desea). El sistema trabaja comparando el renderizado de los dos archivos.
</p><p>reftest se compila e instala ahora automáticamente cuando <code>ENABLE_TESTS</code> está activado (valor predeterminado) y hay pruebas de ejemplo en {{ Source("layout/reftests") }}.
</p><p>Para ejecutar todos estos tests, escribe:
</p><p><code>obj-debug/dist/MinefieldDebug.app/Contents/MacOS/firefox -reftest layout/reftests/reftest.list</code>
</p><p>(Se supone que "make lcheck" debe hacer esto por ti, pero actualmente no funciona).
</p><p>Puedes buscar entre los resultados (usando "grep") la cadena "UNEXPECTED" o ejecutar una de las herramientas de procesado de salida de reftest listadas en el README.
</p><p>Puede que quieras usar un perfil separado para ejecutar los tests (creando un perfil llamado "reftests" y añadiendo <code>-P reftests</code> a la línea que invoca la aplicación).
</p><p>Para más información, acude a {{ Source("layout/tools/reftest/README.txt", "") }} y <a href="es/Crear_pruebas_unitarias_basadas_en_reftest">el tutorial sobre cómo crear un test basado en reftest</a>.
</p>
<h4 name="Crash_tests"> Crash tests </h4>
<p>El <i>framework</i> para pruebas de fallos está basado en el <i>framework</i> reftest, por lo que escribir y ejecutar pruebas es muy parecido. Cada test es un solo archivo y la prueba funciona cargando el archivo y ejecutándolo sin detener el programa ni lanzar aserciones (el <i>framework</i> no vigila explícitamente las aserciones en este momento, necesitarás hacer grep para localizarlas en la salida).
</p><p>Para ejecutar todas las pruebas de fallos, escribe
</p><p><code>obj-debug/dist/MinefieldDebug.app/Contents/MacOS/firefox -reftest testing/crashtest/crashtests.list</code>
</p>
<h3 name="Otra_documentaci.C3.B3n_de_referencia"> Otra documentación de referencia </h3>
<p>Por favor, ignora la página {{ mediawiki.interwiki('wikimo', 'SoftwareTesting:Scratchpad', 'wikimo:SoftwareTesting:Scratchpad') }}, y mira únicamente {{ mediawiki.interwiki('wikimo', 'SoftwareTesting', 'wikimo:SoftwareTesting') }}. La pizarra (<i>Scratchpad</i>) es para trabajos en curso, y casi con toda seguridad estará obsoleta o tendrá documentación errónea.
</p><p>También está {{ mediawiki.interwiki('wikimo', 'SoftwareTesting', 'wikimo:SoftwareTesting') }} y <a href="es/Consejos_y_trucos_para_pruebas_automatizadas">Consejos y trucos para pruebas automatizadas</a> si estás buscando algo que leer.
</p><p>Estos otros esfuerzos están en curso:
</p>
<ul><li> Puedes escribir programas de prueba independientes en C/C++. Esta opción puede usarse para probar funcionalidades no expuestas a través de XPCOM. <ul><li> <i>{{ Bug("343673") }} registra el trabajo de una persona, y parece que ha habido ciertos progresos</i>.
</li><li> <i>{{ Bug("346703") }} contiene un ejemplo de cómo puede hacerse esto</i>.
</li></ul>
</li><li> <a class="external" href="http://www.jsunit.net/">JSUnit</a> puede usarse para escribir pruebas que se ejecutan como contenido en el navegador. Es especialmente útil para tests DOM y del analizador sintáctico, pero no puede hacer nada que requiera privilegios chrome.
<ul><li> JsUnit probablemente no pueda usarse como un objetivo de compilación para make check de momento, ya que necesita una instancia completa de un navegador.
</li><li> {{ mediawiki.interwiki('wikimo', 'SoftwareTesting#Ideas to Collect', 'wikimo:SoftwareTesting#Ideas_to_Collect') }} lista algunos ejemplos de jsunit.
</li><li> Remítete a la documentación en {{ mediawiki.interwiki('wikimo', 'SoftwareTesting:Tools:jsUnit', 'wikimo:SoftwareTesting:Tools:jsUnit') }} para más información.
</li><li> Algunos <a class="external" href="http://beaufour.dk/xftst/">tests de XForms</a> usan JsUnit, a modo de ejemplo.
</li></ul>
</li></ul>
<h3 name="Utilidades_y_frameworks_existentes_para_pruebas"> Utilidades y <i>frameworks</i> existentes para pruebas </h3>
<p>(originalmente de {{ mediawiki.interwiki('wikimo', 'SoftwareTesting:Catalog_of_Automated_Tests', 'wikimo:SoftwareTesting:Catalog_of_Automated_Tests') }})
</p>
<ul><li> <a class="external" href="http://wiki.mozilla.org/Performance:Tinderbox_Tests">Pruebas de rendimiento de Tinderbox</a>
</li><li> <a class="external" href="http://lxr.mozilla.org/mozilla/source/browser/components/places/tests/">Scripts de pruebas de Places</a>
</li><li> <a class="external" href="http://lxr.mozilla.org/mozilla/source/netwerk/test/unit/">Pruebas unitarias de Netwerk</a>
</li><li> <a class="external" href="http://lxr.mozilla.org/mozilla/source/js/tests/">Pruebas de javascript</a>
</li><li> <a class="external" href="http://lxr.mozilla.org/mozilla/source/security/nss/tests/">Pruebas de nss</a>
</li><li> <a class="external" href="http://landfill.mozilla.org/mxr-test/mozilla/source/nsprpub/pr/tests/">Pruebas de nspr</a>
</li><li> <a class="external" href="http://www.mozilla.org/newlayout/doc/regression_tests.html">Pruebas de posicionamiento (<i>layout</i>) - diferencias entre la salida de una versión de prueba y otra de referencia considerada correcta (<i>golden master</i>)</a>
</li><li> <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=301260">copia en bz de los tests de netwerk para xmlserializer</a>
</li><li> <a class="external" href="http://www.w3.org/DOM/Test/">Los tests de W3C DOM</a> usan <a class="external" href="http://www.edwardh.com/jsunit/">jsunit</a>
</li><li> <a class="external" href="http://wiki.mozilla.org/XSLT_Tests">Tests de XSLT</a>
</li><li> <a class=" external" href="http://hixie.ch/tests/MANIFEST" rel="freelink">http://hixie.ch/tests/MANIFEST</a> todos los tests de hixie
</li><li> <a class=" external" href="http://hixie.ch/tests/MANIFEST-visual" rel="freelink">http://hixie.ch/tests/MANIFEST-visual</a> subconjunto de tests de hixie que no es interactivo
</li><li> <a class="external" href="http://www.allpeers.com/blog/2005/09/28/foxunit-unit-test-framework-for-firefox/">FoxUnit</a> - utilidad al estilo jUnit para firefox, por la gente de AllPeers
</li></ul>
{{ languages( { "en": "en/Mozilla_automated_testing" } ) }}
Revertir a esta revisión