GeezerVison

example in [`assert.throws()`][] carefully if using a string as the second

argument gets considered.

* `value` {any} the value to snapshot.

* `name` {string} the name of the snapshot.

* Returns: {Promise}

Reads the `name` snapshot from a file and compares `value` to the snapshot.

`value` is serialized with [`util.inspect()`][]. If the value is not strictly

equal to the snapshot, `assert.snapshot()` returns a rejected `Promise` with an

[`AssertionError`][].

The snapshot filename uses the same basename as the application's main

entrypoint with a `.snapshot` extension. If the snapshot file does not exist,

it is created. The [`--update-assert-snapshot`][] command line flag can be used

to force the update of an existing snapshot.

import assert from 'node:assert/strict';

await assert.snapshot('value', 'snapshotName');

const assert = require('node:assert/strict');

(async () => {

// Assuming that the application's main entrypoint is app.js, this reads the

// 'snapshotName' snapshot from app.snapshot and strictly compares its value

// to `util.inspect('value')`.

await assert.snapshot('value', 'snapshotName');

})();

[Object wrappers]: https://developer.mozilla.org/en-US/docs/Glossary/Primitive#Primitive_wrapper_objects_in_JavaScript

[Object.prototype.toString()]: https://tc39.github.io/ecma262/#sec-object.prototype.tostring

[`!=` operator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Inequality

[`--update-assert-snapshot`]: cli.md#--update-assert-snapshot

[`===` operator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality

[`==` operator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality

[`AssertionError`]: #class-assertassertionerror

[`process.on('exit')`]: process.md#event-exit

[`tracker.calls()`]: #trackercallsfn-exact

[`tracker.verify()`]: #trackerverify

[`util.inspect()`]: util.md#utilinspectobject-options

[enumerable "own" properties]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Enumerability_and_ownership_of_properties

[prototype-spec]: https://tc39.github.io/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots

If a rejection happens during the command line entry point's ES module static

loading phase, it will always raise it as an uncaught exception.

Updates snapshot files used by [`assert.snapshot()`][].

* `--trace-warnings`

* `--track-heap-objects`

* `--unhandled-rejections`

* `--update-assert-snapshot`

* `--use-bundled-ca`

* `--use-largepages`

* `--use-openssl-ca`

[`NO_COLOR`]: https://no-color.org

[`SlowBuffer`]: buffer.md#class-slowbuffer

[`YoungGenerationSizeFromSemiSpaceSize`]: https://chromium.googlesource.com/v8/v8.git/+/refs/tags/10.3.129/src/heap/heap.cc#328

[`assert.snapshot()`]: assert.md#assertsnapshotvalue-name

[`dns.lookup()`]: dns.md#dnslookuphostname-options-callback

[`dns.setDefaultResultOrder()`]: dns.md#dnssetdefaultresultorderorder

[`dnsPromises.lookup()`]: dns.md#dnspromiseslookuphostname-options

exceptional logic violation that should never occur. These are raised typically

by the `node:assert` module.

<a id="ERR_ASSERT_SNAPSHOT_NOT_SUPPORTED"></a>

An attempt was made to use `assert.snapshot()` in an environment that

does not support snapshots, such as the REPL, or when using `node --eval`.

<a id="ERR_ASYNC_CALLBACK"></a>

.It Fl -unhandled-rejections=mode

Define the behavior for unhandled rejections. Can be one of `strict` (raise an error), `warn` (enforce warnings) or `none` (silence warnings).

.It Fl -update-assert-snapshot

Updates snapshot files used by `assert.snapshot()`.

.It Fl -use-bundled-ca , Fl -use-openssl-ca

Use bundled Mozilla CA store as supplied by current Node.js version or use OpenSSL's default CA store.

The default store is selectable at build-time.

assert.CallTracker = CallTracker;

const snapshot = require('internal/assert/snapshot');

assert.snapshot = snapshot;

E('ERR_AMBIGUOUS_ARGUMENT', 'The "%s" argument is ambiguous. %s', TypeError);

E('ERR_ARG_NOT_ITERABLE', '%s must be iterable', TypeError);

E('ERR_ASSERTION', '%s', Error);

'Snapshot is not supported in this context ', TypeError);

E('ERR_ASYNC_CALLBACK', '%s must be a function', TypeError);

E('ERR_ASYNC_TYPE', 'Invalid name for async "type": %s', TypeError);

E('ERR_BROTLI_INVALID_PARAM', '%s is not a valid Brotli parameter', RangeError);

&EnvironmentOptions::force_repl);

AddAlias("-i", "--interactive");

AddOption("--update-assert-snapshot",

"update assert snapshot files",

&EnvironmentOptions::update_assert_snapshot,

kAllowedInEnvvar);

AddOption("--napi-modules", "", NoOp{}, kAllowedInEnvvar);

AddOption("--tls-keylog",

bool preserve_symlinks = false;

bool preserve_symlinks_main = false;

bool prof_process = false;

bool update_assert_snapshot = false;

#if HAVE_INSPECTOR

std::string cpu_prof_dir;

static const uint64_t kDefaultCpuProfInterval = 1000;