Skip to content
Allure report logoAllure Report
Main Navigation MódulosDocumentaciónStart

Español

English

Español

English

Appearance

Sidebar Navigation

Introducción

Instalación y Actualización

Instalación para Windows

Instalación para macOS

Instalación para Linux

Instalación para Node.js

Actualización

Primeros pasos

Cómo ver un informe

Mejorar la legibilidad de informes

Mejorar la navegación en informe

Funcionalidades

Pasos de prueba

Adjuntos

Estados de prueba

Ordenar y filtrar

Categorías de defectos

Análisis visual

Análisis de estabilidad de prueba

Historial y reintentos

Cronología

Exportar a CSV

Exportar métricas

Guías

Parametrización JUnit 5

JUnit 5 & Selenide: capturas de pantalla y adjuntos

JUnit 5 & Selenium: capturas de pantalla y adjuntos

Configurar JUnit 5 con GitHub Actions

Parametrización en Pytest

Pytest & Selenium: capturas de pantalla y adjuntos

Pytest & Playwright: capturas de pantalla y adjuntos

Pytest & Playwright: videos

Parametrización en Playwright

Cómo funciona

Visión general

Archivo de resultados de prueba

Archivo de contenedor

Archivo de categorías

Archivo de entorno

Archivo de ejecutor

Archivos de historial

Integraciones

Azure DevOps

Bamboo

GitHub Actions

Jenkins

IDEs de JetBrains

TeamCity

Visual Studio Code

Frameworks

Behat

Empezando

Configuración

Referencia

Behave

Empezando

Configuración

Referencia

Codeception

Empezando

Configuración

Referencia

CodeceptJS

Empezando

Configuración

Referencia

Cucumber.js

Empezando

Configuración

Referencia

Cucumber-JVM

Empezando

Configuración

Referencia

Cucumber.rb

Empezando

Configuración

Referencia

Cypress

Empezando

Configuración

Referencia

Jasmine

Empezando

Configuración

Referencia

JBehave

Empezando

Configuración

Referencia

Jest

Empezando

Configuración

Referencia

JUnit 4

Empezando

Configuración

Referencia

JUnit 5

Empezando

Configuración

Referencia

Mocha

Empezando

Configuración

Referencia

Newman

Empezando

Configuración

Referencia

NUnit

Empezando

Configuración

Referencia

PHPUnit

Empezando

Configuración

Referencia

Playwright

Empezando

Configuración

Referencia

pytest

Empezando

Configuración

Referencia

Pytest-BDD

Empezando

Configuración

Referencia

Reqnroll

Empezando

Configuración

Referencia

REST Assured

Empezando

Configuración

Robot Framework

Empezando

Configuración

Referencia

RSpec

Empezando

Configuración

Referencia

SpecFlow

Empezando

Configuración

Referencia

Spock

Empezando

Configuración

Referencia

TestNG

Empezando

Configuración

Referencia

Vitest

Empezando

Configuración

Referencia

WebdriverIO

Empezando

Configuración

Referencia

xUnit.net

Empezando

Configuración

Referencia

On this page

Referencia de Allure Jest ​

Estas son las funciones que puedes usar para integrar tus pruebas de Jest con Allure.

En la mayoría de los casos, Allure Jest ofrece dos formas diferentes de usar una función: la API de Tiempo de Ejecución (Runtime API) y la API de Metadatos (Metadata API).

  • API de Tiempo de Ejecución (Runtime API): utiliza las funciones de Allure para agregar ciertos datos al resultado de la prueba durante su ejecución. Este enfoque permite construir los datos de manera dinámica.

    Ten en cuenta que se recomienda llamar a las funciones de Allure lo más cerca posible del inicio de la prueba. De esta manera, los datos se agregarán incluso si la prueba falla al principio.

  • API de Metadatos (Metadata API): agrega una etiqueta de metadatos (que comienza con @) en el nombre de la prueba. Allure Jest extraerá esta etiqueta y actualizará los datos del resultado de la prueba en consecuencia. Al usar este enfoque, se garantiza que los datos se agregarán independientemente de cómo se ejecute la prueba.

Metadatos ​

Asigna descripción, enlaces y otros metadatos a una prueba.

Title ​

  • allure.displayName(name: string): PromiseLike<void>

Establece el título de la prueba.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.displayName("Test Authentication");
  // ...
});

Description ​

  • allure.description(markdown: string): PromiseLike<void>

Establece la descripción de la prueba. Se permite el formato en Markdown. Cualquier formato HTML, si está presente, se eliminará por razones de seguridad.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.description("This test attempts to log into the website.");
  // ...
});

Owner ​

  • allure.owner(name: string): PromiseLike<void>
  • @allure.label.owner:⟨VALUE⟩

Establece el propietario de la prueba.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.owner("John Doe");
  // ...
});
js
it("Test Authentication @allure.label.owner:JohnDoe", async () => {
  // ...
});

Tag ​

  • allure.tag(name: string): PromiseLike<void>
  • allure.tags(...tagsList: string[]): PromiseLike<void>
  • @allure.label.tag:⟨VALUE⟩

Establece los tags de la prueba.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.tag("New UI");
  await allure.tags("Essentials", "Authentication");
  // ...
});
js
it(
  "Test Authentication" +
    " @allure.label.tag:NewUI" +
    " @allure.label.tag:Essentials" +
    " @allure.label.tag:Authentication",
  async () => {
    // ...
  },
);

Severity ​

  • allure.severity(name: string): PromiseLike<void>
  • @allure.label.severity:⟨VALUE⟩

Establece la severidad de la prueba.

Los valores permitidos son: “trivial”, “minor”, “normal”, “critical”, y “blocker”.

js
import * as allure from "allure-js-commons";
import { Severity } from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.severity(Severity.CRITICAL);
  // ...
});
js
it("Test Authentication @allure.label.severity:critical", async () => {
  // ...
});

Label ​

  • allure.label(name: LabelName | string, value: string): PromiseLike<void>
  • allure.labels(...labelsList: Label[]): PromiseLike<void>
  • @allure.label.⟨NAME⟩:⟨VALUE⟩

Establece una etiqueta arbitraria para la prueba. Esta es la implementación subyacente para muchas de las otras funciones de Allure.

Puedes llamar a label() múltiples veces para crear un arreglo de valores bajo el nombre dado.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.label("microservice", "UI");
  // ...
});
js
it("Test Authentication @allure.label.microservice:UI", async () => {
  // ...
});

ID ​

  • @allure.id:⟨VALUE⟩

Establece el ID de la prueba.

js
import * as allure from "allure-js-commons";

it("Test Authentication @allure.id:123", async () => {
  // ...
});

Link ​

  • allure.link(url: string, name?: string, type?: LinkType | string): PromiseLike<void>
  • allure.links(...linksList: Link[]): PromiseLike<void>
  • allure.issue(url: string, name?: string): PromiseLike<void>
  • allure.tms(url: string, name?: string): PromiseLike<void>

Agrega un enlace relacionado con la prueba.

Según el type (que puede ser cualquier cadena, por defecto es “link”), Allure intentará cargar una plantilla de enlace correspondiente para procesar la URL, como se define en la opción de configuración links. Si no se encuentra una plantilla para el tipo dado o si el enlace ya representa una URL válida, se dejará sin modificar.

El name se usará como el texto del enlace. Si se omite, se usará la URL en su lugar.

Para mayor comodidad, Allure proporciona dos funciones abreviadas con tipos de enlace preseleccionados: issue y tms.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.issue("AUTH-123", "Related issue");
  await allure.tms("TMS-456", "Related TMS issue");
  await allure.link("JIRA-777", "Related Jira issue", "jira");
  await allure.link("https://example.com/", "Project website");
  // ...
});

Jerarquía basada en el comportamiento ​

  • allure.epic(name: string): PromiseLike<void>
  • allure.feature(name: string): PromiseLike<void>
  • allure.story(name: string): PromiseLike<void>
  • @allure.label.epic:⟨VALUE⟩
  • @allure.label.feature:⟨VALUE⟩
  • @allure.label.story:⟨VALUE⟩

Asigna nombres de epics, features o historias de usuario para una prueba, como parte de la jerarquía basada en el comportamiento de Allure.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.epic("Web interface");
  await allure.feature("Essential features");
  await allure.story("Authentication");
  // ...
});
js
it(
  "Test Authentication" +
    " @allure.label.epic:WebInterface" +
    " @allure.label.feature:EssentialFeatures" +
    " @allure.label.story:Authentication",
  async () => {
    // ...
  },
);

Jerarquía basada en la suite ​

Asigna los nombres de suite principal, suite o sub-suite para una prueba, como parte de la jerarquía basada en la suite de Allure.

js
import * as allure from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.parentSuite("Tests for web interface");
  await allure.suite("Tests for essential features");
  await allure.subSuite("Tests for authentication");
  // ...
});
js
it(
  "Test Authentication" +
    " @allure.label.parentSuite:TestsForWebInterface" +
    " @allure.label.suite:TestsForEssentialFeatures" +
    " @allure.label.subSuite:TestsForAuthentication",
  async () => {
    // ...
  },
);

Pasos de prueba ​

Define un paso de prueba con el nombre dado.

Hay dos formas de definir un paso.

  • Pasos Lambda

    Escribe un paso de prueba en una función y pásalo a allure.step(). Si la función devuelve un valor, allure.step() lo devolverá sin modificaciones y no afectará al informe. Si devuelve una promesa, se esperará y resolverá.

    La función puede aceptar ningún argumento o un solo objeto de tipo StepContext. Este objeto proporciona los siguientes métodos:

    • displayName() — sobrescribe el nombre del paso durante su ejecución.
    • parameter() — indica parámetros arbitrarios utilizados para el paso. Las firmas disponibles de este método son similares a la implementación a nivel de prueba, consulta Pruebas parametrizadas.
  • Pasos No-op

    Si llamas a allure.logStep(), Allure agregará al informe un paso no-op. Esto permite un informe al estilo de un registro dentro de una prueba o dentro de un paso más grande. Un paso no-op termina inmediatamente después de que comienza y no puede tener sub-pasos ni parámetros.

    El segundo argumento opcional indica el estado que se mostrará para el paso en el informe. Los valores permitidos son: Status.PASSED (el valor predeterminado), Status.FAILED, Status.BROKEN y Status.SKIPPED.

    El tercer argumento opcional es un objeto Error. Cuando se proporciona, los datos de este objeto se mostrarán en un mensaje dentro del paso.

js
import * as allure from "allure-js-commons";
import { Status } from "allure-js-commons";

it("Test Authentication", async () => {
  await allure.step("Step 1", async () => {
    await allure.step("Sub-step 1", async (ctx) => {
      await ctx.parameter("foo", "1");
      // ...
    });
    await allure.step("Sub-step 2", async (ctx) => {
      await ctx.parameter("foo", "2");
      // ...
    });
  });
  await allure.logStep("Step 2", Status.SKIPPED);
});

Pruebas parametrizadas ​

  • allure.parameter(name: string, value: string, options?: ParameterOptions): PromiseLike<void>

Especifica un nombre y valor de un parámetro que se utilizó durante esta prueba. Consulta Pruebas parametrizadas para más detalles.

El argumento options, si se proporciona, debe ser un objeto con dos propiedades opcionales: excluded y mode.

  • Si excluded se establece en verdadero, Allure no usará el parámetro al comparar el resultado de la prueba actual con el anterior en el historial. Consulta Error común: los reintentos de una prueba se muestran como pruebas separadas.

  • El mode afecta cómo se mostrará el parámetro en el informe. Las opciones disponibles son:

    • "default" (lo mismo que no especificar ningún modo) — el parámetro y su valor se mostrarán en una tabla junto con otros parámetros.
    • "masked" — el parámetro se mostrará en la tabla, pero su valor estará oculto. Usa este modo para contraseñas, tokens y otros parámetros sensibles.
    • "hidden" — el parámetro y su valor no se mostrarán en el informe de la prueba.

    Ten en cuenta que, incluso cuando uses el modo "masked" o "hidden", todavía es posible extraer el valor del directorio allure_results si lo publicas.

js
import * as allure from "allure-js-commons";

test.each([["johndoe"], ["[email protected]"]])("Test Authentication as %s", async (login) => {
  await allure.parameter("login", login);
  await allure.parameter("time", new Date().toUTCString(), { excluded: true });
  // ...
});

Archivos adjuntos ​

  • allure.attachment(name: string, content: Buffer | string, options: ContentType | string | AttachmentOptions): PromiseLike<void>
  • allure.attachmentPath(name: string, path: string, options: ContentType | string | Omit<AttachmentOptions, "encoding">): PromiseLike<void>

Agrega un archivo adjunto al resultado de la prueba bajo el nombre dado. Pasa ya sea el contenido o la ruta desde la cual se leerán los datos.

El argumento options controla el tipo de medio del contenido y la extensión de archivo que se usará si un usuario descarga el archivo adjunto desde el informe de la prueba. Puedes especificar ambas opciones en un objeto (como se muestra para el archivo adjunto de imagen a continuación) o simplemente especificar el tipo de medio y dejar que Allure deduzca automáticamente la extensión de archivo adecuada (como se muestra para el archivo adjunto de texto a continuación). En cualquier caso, el tipo de medio puede ser un valor de la enumeración ContentType o cualquier cadena.

js
import * as allure from "allure-js-commons";
import { ContentType } from "allure-js-commons";

it("Test Authentication", async () => {
  // ...

  await allure.attachment("Text file", "This is the file content.", ContentType.TEXT);

  await allure.attachmentPath("Screenshot", "/path/to/image.png", {
    contentType: ContentType.PNG,
    fileExtension: "png",
  });
});
Pager
Previous pageConfiguración
Next pageEmpezando
Powered by

Únete a nuestro boletín

Allure TestOps
  • Visión general
  • Por qué elegirnos
  • Nube
  • Autoalojado
  • Historias de éxito
Compañía
  • Documentación
  • Blog
  • Sobre nosotros
  • Contacto
  • Eventos
© 2025 Qameta Software Inc. All rights reserved.