Function timingSafeEqual

  • When checking the values of cryptographic hashes are equal, default comparisons can be susceptible to timing based attacks, where attacker is able to find out information about the host system by repeatedly checking response times to equality comparisons of values.

    It is likely some form of timing safe equality will make its way to the WebCrypto standard (see: w3c/webcrypto#270), but until that time, timingSafeEqual() is provided:

    Parameters

    • a: ArrayBufferView | ArrayBufferLike | DataView

      The first value to compare.

    • b: ArrayBufferView | ArrayBufferLike | DataView

      The second value to compare.

    Returns boolean

    true if the values are equal, otherwise false.

    import { timingSafeEqual } from "@std/crypto/timing-safe-equal";
    import { assert } from "@std/assert";

    const a = await crypto.subtle.digest(
    "SHA-384",
    new TextEncoder().encode("hello world"),
    );
    const b = await crypto.subtle.digest(
    "SHA-384",
    new TextEncoder().encode("hello world"),
    );

    assert(timingSafeEqual(a, b));