Facilitate "close to" number equal assertion about qunit HOT 3 CLOSED

Just wanted to swing by to say thanks for the note, Timo! ❤

I added a README notice in JamesMGreene/qunit-assert-close@e0300ba and archived the repo. 🗄 🧹

from qunit.

I support including this, and there's even a use case in jQuery for asserting that early progress of an element animation approximates the pre-animation state (rather than e.g. introducing a discontinuity based on unit mismatch) at https://github.com/jquery/jquery/blob/99151d7ab0923aa3aeeb1b957a9063e4e20d31ae/test/unit/effects.js#L1830-L1832 .

from qunit.

Peer review of implementations:

• qunit-assert-close:
  Boils down to Math.abs(actual - expected) <= delta
  https://github.com/JamesMGreene/qunit-assert-close/blob/v2.1.2/qunit-assert-close.js

• Chai:
  Idem, Math.abs(actual - expected) <= delta
  https://github.com/chaijs/chai/blob/v5.1.1/lib/chai/core/assertions.js#L3010

• Deno
  Similar, albeit swapped, reducing to Math.abs(expected - actual) <= tolerance
  https://github.com/denoland/deno_std/blob/0.224.0/assert/assert_almost_equals.ts#L21

• Expect.js
  Different approach as "within(min, max)"
  using result = actual >= min && actual <= max
  https://github.com/Automattic/expect.js/blob/0.3.1/index.js#L246

• Jasmine (and therefore Jest)
  Different approach as "toBeCloseTo(,,precision=2)" where precision is the number of digits, not the delta. The main logic here is:

  const pow = Math.pow(10, precision + 1);
  const delta = Math.abs(expected - actual);
  const maxDelta = Math.pow(10, -precision) / 2;
  result = Math.round(delta * pow) <= maxDelta * pow

  https://github.com/jasmine/jasmine/blob/v5.1.2/src/core/matchers/toBeCloseTo.js#L38

I'm going to go with @JamesMGreene 's qunit-assert-close for the most part, with an added type check in case the delta argumet is missing, to catch otherwise-subtle mistakes.

from qunit.