Function timingSafeEqual
- timing
Safe (a, b): booleanEqual Parameters
- a: ArrayBufferView | ArrayBufferLike | DataView
The first value to compare.
- b: ArrayBufferView | ArrayBufferLike | DataView
The second value to compare.
Returns boolean
trueif the values are equal, otherwisefalse.Example: Usage
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));- a: ArrayBufferView | ArrayBufferLike | DataView
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: