Nevertheless Published Mine

    TypeScript icon, indicating that this package has built-in type declarations

    2.0.0 • Public • Published


    cy-dom-diff allows matching chunks of DOM against HTML; including dynamic content.


    cy-dom-diff consist of two parts. First is a Cypress command that matches a DOM element against a regular expression. When a DOM element is matched its HTML is normalized to produce consistent diffable output while maintaining sematic meaning. This includes:

    • whitespace and newlines are normalized
    • tags and attributes are printed on individual lines
    • comments are removed
    • tags and attributes can be ignored through configuration

    In the second part cy-dom-diff provides a template function to generate a regular expression from a HTML string. This HTML string is passed through the same normalization as the DOM element (described above) as well as allowing embedded regular expression for dynamic content.

    Installation and Setup

    npm install --save-dev @swimlane/cy-dom-diff

    Import the Cypress commands in cypress/support/index.js or cypress/support/commands.js

    import '@swimlane/cy-dom-diff/commands';


    In a basic example the following will assert that the element matches the regexp generated by the dom template tag. Most of the HTML string within the tagged template string is treated literally. However, regular expressions within the embedded expression are matches as expected.

    import { dom } from '@swimlane/cy-dom-diff';
    const TIME = /\d?\d:\d?\d\:\d?\d/;
    const NUMBER = /[\+\-]?\d*\.?\d+(?:[Ee][\+\-]?\d+)?/;
        <span>The current time is:</span>
        <span class="clock">${TIME} ${/[AP]/}M</span>
        <span class="offset">${NUMBER}</span> hrs

    cy.domMatch Cypress command

    cy.domMatch will run the domMatch assertions (see below) and add a Cypress runner log with a diff.

    cy.domDiff Cypress command

    cy.domDiff is used in the same way as cy.domMatch but will only add a Cypress runner log with a diff. It will not fail if the DOM does not match and will not retry.

    domMatch Chai assertion

    At its lowest level cy-dom-diff adds a Chai assertion for matching the DOM. This will not generate a Cypress log except to show that the assertion passed or failed. Use cy.domMatch to get better logging.

    import { dom } from '@swimlane/cy-dom-diff';
    const TIME = /\d?\d:\d?\d\:\d?\d/;
    const NUMBER = /[\+\-]?\d*\.?\d+(?:[Ee][\+\-]?\d+)?/;
    cy.get('#clock').should('domMatch', dom`
      <span>The current time is:</span>
      <span class="clock">${TIME} ${/[AP]/}M</span>
      <span class="offset">${NUMBER}</span> hrs
    // OR
    cy.get('#clock').then($el => {
        <span>The current time is:</span>
        <span class="clock">${TIME} ${/[AP]/}M</span>
        <span class="offset">${NUMBER}</span> hrs


    cy-dom-diff is a Swimlane open-source project; we believe in giving back to the open-source community by sharing some of the projects we build for our application. Swimlane is an automated cyber security operations and incident response platform that enables cyber security teams to leverage threat intelligence, speed up incident response and automate security operations.


    npm i @swimlane/cy-dom-diff

    DownloadsWeekly Downloads






    Unpacked Size

    14.2 kB

    Total Files


    Last publish


    • msadministrator
    • pavel.herasimov
    • dabbott-sl
    • hernan-erasmo
    • rosvin
    • daniel.selig
    • thedude2004
    • jogaj_26
    • markcoleman1
    • gabriel.almeida.swimlane
    • cdhumes
    • johnapclaw
    • caleb.bass
    • hansstoetzer
    • drazafsky
    • sarath.pantula
    • jp.menezes
    • nikkuman
    • matias.vazquez
    • agustin.firpo
    • luis.duque
    • tmcclure
    • claudio.andrade
    • ischultz-swimlane
    • bensteele7
    • brantw
    • marjan-georgiev
    • danstory
    • hypercubed
    • seangrimes
    • michael.baswell
    • duredhel
    • dmikov
    • amiranda
    • jorgemontero
    • ngutierrez
    • adamfrank
    • parayacr
    • danguloa
    • dcookswim
    • tflintswim
    • jgrannan
    • bageldawg
    • malvarado25
    • it.admin.swim
    • smartinski
    • mattepp
    • vterziski
    • lisa-reynolds
    • josep.campos
    • royar95
    • tanner.lewis
    • mr_charlie