cdk-ecr-deployment 3.0.33 → 3.0.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/.jsii +2 -2
  2. package/.jsii.tabl.json +1 -1
  3. package/lib/index.js +3 -3
  4. package/node_modules/@types/cacheable-request/node_modules/@types/node/README.md +1 -1
  5. package/node_modules/@types/cacheable-request/node_modules/@types/node/crypto.d.ts +1 -1
  6. package/node_modules/@types/cacheable-request/node_modules/@types/node/package.json +3 -10
  7. package/node_modules/@types/keyv/node_modules/@types/node/README.md +1 -1
  8. package/node_modules/@types/keyv/node_modules/@types/node/crypto.d.ts +1 -1
  9. package/node_modules/@types/keyv/node_modules/@types/node/package.json +3 -10
  10. package/node_modules/@types/responselike/node_modules/@types/node/README.md +1 -1
  11. package/node_modules/@types/responselike/node_modules/@types/node/crypto.d.ts +1 -1
  12. package/node_modules/@types/responselike/node_modules/@types/node/package.json +3 -10
  13. package/package.json +3 -3
  14. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/assert/strict.d.ts +0 -8
  15. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/assert.d.ts +0 -996
  16. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/async_hooks.d.ts +0 -539
  17. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/buffer.d.ts +0 -2363
  18. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/child_process.d.ts +0 -1540
  19. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/cluster.d.ts +0 -432
  20. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/console.d.ts +0 -415
  21. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/constants.d.ts +0 -19
  22. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/crypto.d.ts +0 -4487
  23. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/dgram.d.ts +0 -596
  24. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/diagnostics_channel.d.ts +0 -545
  25. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/dns/promises.d.ts +0 -425
  26. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/dns.d.ts +0 -809
  27. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/dom-events.d.ts +0 -122
  28. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/domain.d.ts +0 -170
  29. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/events.d.ts +0 -896
  30. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/fs/promises.d.ts +0 -1239
  31. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/fs.d.ts +0 -4311
  32. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/globals.d.ts +0 -411
  33. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/globals.global.d.ts +0 -1
  34. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/http.d.ts +0 -1889
  35. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/http2.d.ts +0 -2382
  36. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/https.d.ts +0 -550
  37. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/index.d.ts +0 -88
  38. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/inspector.d.ts +0 -2747
  39. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/module.d.ts +0 -315
  40. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/net.d.ts +0 -954
  41. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/os.d.ts +0 -478
  42. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/path.d.ts +0 -191
  43. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/perf_hooks.d.ts +0 -645
  44. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/process.d.ts +0 -1561
  45. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/punycode.d.ts +0 -117
  46. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/querystring.d.ts +0 -141
  47. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/readline/promises.d.ts +0 -150
  48. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/readline.d.ts +0 -539
  49. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/repl.d.ts +0 -430
  50. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/stream/consumers.d.ts +0 -12
  51. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/stream/promises.d.ts +0 -83
  52. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/stream/web.d.ts +0 -366
  53. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/stream.d.ts +0 -1701
  54. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/string_decoder.d.ts +0 -67
  55. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/test.d.ts +0 -1465
  56. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/timers/promises.d.ts +0 -93
  57. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/timers.d.ts +0 -240
  58. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/tls.d.ts +0 -1210
  59. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/trace_events.d.ts +0 -182
  60. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/tty.d.ts +0 -208
  61. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/url.d.ts +0 -944
  62. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/util.d.ts +0 -2183
  63. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/v8.d.ts +0 -764
  64. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/vm.d.ts +0 -903
  65. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/wasi.d.ts +0 -179
  66. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/worker_threads.d.ts +0 -691
  67. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts4.8/zlib.d.ts +0 -517
  68. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/assert/strict.d.ts +0 -8
  69. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/assert.d.ts +0 -996
  70. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/async_hooks.d.ts +0 -539
  71. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/buffer.d.ts +0 -2363
  72. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/child_process.d.ts +0 -1540
  73. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/cluster.d.ts +0 -432
  74. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/console.d.ts +0 -415
  75. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/constants.d.ts +0 -19
  76. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/crypto.d.ts +0 -4487
  77. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/dgram.d.ts +0 -596
  78. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/diagnostics_channel.d.ts +0 -545
  79. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/dns/promises.d.ts +0 -425
  80. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/dns.d.ts +0 -809
  81. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/dom-events.d.ts +0 -122
  82. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/domain.d.ts +0 -170
  83. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/events.d.ts +0 -896
  84. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/fs/promises.d.ts +0 -1239
  85. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/fs.d.ts +0 -4311
  86. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/globals.d.ts +0 -411
  87. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/globals.global.d.ts +0 -1
  88. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/http.d.ts +0 -1889
  89. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/http2.d.ts +0 -2382
  90. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/https.d.ts +0 -550
  91. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/index.d.ts +0 -88
  92. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/inspector.d.ts +0 -2747
  93. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/module.d.ts +0 -315
  94. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/net.d.ts +0 -954
  95. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/os.d.ts +0 -478
  96. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/path.d.ts +0 -191
  97. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/perf_hooks.d.ts +0 -645
  98. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/process.d.ts +0 -1561
  99. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/punycode.d.ts +0 -117
  100. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/querystring.d.ts +0 -141
  101. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/readline/promises.d.ts +0 -150
  102. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/readline.d.ts +0 -539
  103. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/repl.d.ts +0 -430
  104. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/stream/consumers.d.ts +0 -12
  105. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/stream/promises.d.ts +0 -83
  106. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/stream/web.d.ts +0 -366
  107. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/stream.d.ts +0 -1701
  108. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/string_decoder.d.ts +0 -67
  109. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/test.d.ts +0 -1465
  110. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/timers/promises.d.ts +0 -93
  111. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/timers.d.ts +0 -240
  112. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/tls.d.ts +0 -1210
  113. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/trace_events.d.ts +0 -182
  114. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/tty.d.ts +0 -208
  115. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/url.d.ts +0 -944
  116. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/util.d.ts +0 -2183
  117. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/v8.d.ts +0 -764
  118. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/vm.d.ts +0 -903
  119. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/wasi.d.ts +0 -179
  120. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/worker_threads.d.ts +0 -691
  121. package/node_modules/@types/keyv/node_modules/@types/node/ts4.8/zlib.d.ts +0 -517
  122. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/assert/strict.d.ts +0 -8
  123. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/assert.d.ts +0 -996
  124. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/async_hooks.d.ts +0 -539
  125. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/buffer.d.ts +0 -2363
  126. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/child_process.d.ts +0 -1540
  127. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/cluster.d.ts +0 -432
  128. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/console.d.ts +0 -415
  129. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/constants.d.ts +0 -19
  130. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/crypto.d.ts +0 -4487
  131. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/dgram.d.ts +0 -596
  132. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/diagnostics_channel.d.ts +0 -545
  133. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/dns/promises.d.ts +0 -425
  134. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/dns.d.ts +0 -809
  135. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/dom-events.d.ts +0 -122
  136. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/domain.d.ts +0 -170
  137. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/events.d.ts +0 -896
  138. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/fs/promises.d.ts +0 -1239
  139. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/fs.d.ts +0 -4311
  140. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/globals.d.ts +0 -411
  141. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/globals.global.d.ts +0 -1
  142. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/http.d.ts +0 -1889
  143. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/http2.d.ts +0 -2382
  144. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/https.d.ts +0 -550
  145. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/index.d.ts +0 -88
  146. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/inspector.d.ts +0 -2747
  147. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/module.d.ts +0 -315
  148. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/net.d.ts +0 -954
  149. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/os.d.ts +0 -478
  150. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/path.d.ts +0 -191
  151. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/perf_hooks.d.ts +0 -645
  152. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/process.d.ts +0 -1561
  153. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/punycode.d.ts +0 -117
  154. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/querystring.d.ts +0 -141
  155. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/readline/promises.d.ts +0 -150
  156. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/readline.d.ts +0 -539
  157. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/repl.d.ts +0 -430
  158. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/stream/consumers.d.ts +0 -12
  159. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/stream/promises.d.ts +0 -83
  160. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/stream/web.d.ts +0 -366
  161. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/stream.d.ts +0 -1701
  162. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/string_decoder.d.ts +0 -67
  163. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/test.d.ts +0 -1465
  164. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/timers/promises.d.ts +0 -93
  165. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/timers.d.ts +0 -240
  166. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/tls.d.ts +0 -1210
  167. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/trace_events.d.ts +0 -182
  168. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/tty.d.ts +0 -208
  169. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/url.d.ts +0 -944
  170. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/util.d.ts +0 -2183
  171. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/v8.d.ts +0 -764
  172. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/vm.d.ts +0 -903
  173. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/wasi.d.ts +0 -179
  174. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/worker_threads.d.ts +0 -691
  175. package/node_modules/@types/responselike/node_modules/@types/node/ts4.8/zlib.d.ts +0 -517
@@ -1,996 +0,0 @@
1
- /**
2
- * The `node:assert` module provides a set of assertion functions for verifying
3
- * invariants.
4
- * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/assert.js)
5
- */
6
- declare module "assert" {
7
- /**
8
- * An alias of {@link ok}.
9
- * @since v0.5.9
10
- * @param value The input that is checked for being truthy.
11
- */
12
- function assert(value: unknown, message?: string | Error): asserts value;
13
- namespace assert {
14
- /**
15
- * Indicates the failure of an assertion. All errors thrown by the `node:assert`module will be instances of the `AssertionError` class.
16
- */
17
- class AssertionError extends Error {
18
- /**
19
- * Set to the `actual` argument for methods such as {@link assert.strictEqual()}.
20
- */
21
- actual: unknown;
22
- /**
23
- * Set to the `expected` argument for methods such as {@link assert.strictEqual()}.
24
- */
25
- expected: unknown;
26
- /**
27
- * Set to the passed in operator value.
28
- */
29
- operator: string;
30
- /**
31
- * Indicates if the message was auto-generated (`true`) or not.
32
- */
33
- generatedMessage: boolean;
34
- /**
35
- * Value is always `ERR_ASSERTION` to show that the error is an assertion error.
36
- */
37
- code: "ERR_ASSERTION";
38
- constructor(options?: {
39
- /** If provided, the error message is set to this value. */
40
- message?: string | undefined;
41
- /** The `actual` property on the error instance. */
42
- actual?: unknown | undefined;
43
- /** The `expected` property on the error instance. */
44
- expected?: unknown | undefined;
45
- /** The `operator` property on the error instance. */
46
- operator?: string | undefined;
47
- /** If provided, the generated stack trace omits frames before this function. */
48
- // eslint-disable-next-line @typescript-eslint/ban-types
49
- stackStartFn?: Function | undefined;
50
- });
51
- }
52
- /**
53
- * This feature is deprecated and will be removed in a future version.
54
- * Please consider using alternatives such as the `mock` helper function.
55
- * @since v14.2.0, v12.19.0
56
- * @deprecated Deprecated
57
- */
58
- class CallTracker {
59
- /**
60
- * The wrapper function is expected to be called exactly `exact` times. If the
61
- * function has not been called exactly `exact` times when `tracker.verify()` is called, then `tracker.verify()` will throw an
62
- * error.
63
- *
64
- * ```js
65
- * import assert from 'node:assert';
66
- *
67
- * // Creates call tracker.
68
- * const tracker = new assert.CallTracker();
69
- *
70
- * function func() {}
71
- *
72
- * // Returns a function that wraps func() that must be called exact times
73
- * // before tracker.verify().
74
- * const callsfunc = tracker.calls(func);
75
- * ```
76
- * @since v14.2.0, v12.19.0
77
- * @param [fn='A no-op function']
78
- * @param [exact=1]
79
- * @return that wraps `fn`.
80
- */
81
- calls(exact?: number): () => void;
82
- calls<Func extends (...args: any[]) => any>(fn?: Func, exact?: number): Func;
83
- /**
84
- * Example:
85
- *
86
- * ```js
87
- * import assert from 'node:assert';
88
- *
89
- * const tracker = new assert.CallTracker();
90
- *
91
- * function func() {}
92
- * const callsfunc = tracker.calls(func);
93
- * callsfunc(1, 2, 3);
94
- *
95
- * assert.deepStrictEqual(tracker.getCalls(callsfunc),
96
- * [{ thisArg: undefined, arguments: [1, 2, 3] }]);
97
- * ```
98
- * @since v18.8.0, v16.18.0
99
- * @param fn
100
- * @return An Array with all the calls to a tracked function.
101
- */
102
- getCalls(fn: Function): CallTrackerCall[];
103
- /**
104
- * The arrays contains information about the expected and actual number of calls of
105
- * the functions that have not been called the expected number of times.
106
- *
107
- * ```js
108
- * import assert from 'node:assert';
109
- *
110
- * // Creates call tracker.
111
- * const tracker = new assert.CallTracker();
112
- *
113
- * function func() {}
114
- *
115
- * // Returns a function that wraps func() that must be called exact times
116
- * // before tracker.verify().
117
- * const callsfunc = tracker.calls(func, 2);
118
- *
119
- * // Returns an array containing information on callsfunc()
120
- * console.log(tracker.report());
121
- * // [
122
- * // {
123
- * // message: 'Expected the func function to be executed 2 time(s) but was
124
- * // executed 0 time(s).',
125
- * // actual: 0,
126
- * // expected: 2,
127
- * // operator: 'func',
128
- * // stack: stack trace
129
- * // }
130
- * // ]
131
- * ```
132
- * @since v14.2.0, v12.19.0
133
- * @return An Array of objects containing information about the wrapper functions returned by `calls`.
134
- */
135
- report(): CallTrackerReportInformation[];
136
- /**
137
- * Reset calls of the call tracker.
138
- * If a tracked function is passed as an argument, the calls will be reset for it.
139
- * If no arguments are passed, all tracked functions will be reset.
140
- *
141
- * ```js
142
- * import assert from 'node:assert';
143
- *
144
- * const tracker = new assert.CallTracker();
145
- *
146
- * function func() {}
147
- * const callsfunc = tracker.calls(func);
148
- *
149
- * callsfunc();
150
- * // Tracker was called once
151
- * assert.strictEqual(tracker.getCalls(callsfunc).length, 1);
152
- *
153
- * tracker.reset(callsfunc);
154
- * assert.strictEqual(tracker.getCalls(callsfunc).length, 0);
155
- * ```
156
- * @since v18.8.0, v16.18.0
157
- * @param fn a tracked function to reset.
158
- */
159
- reset(fn?: Function): void;
160
- /**
161
- * Iterates through the list of functions passed to `tracker.calls()` and will throw an error for functions that
162
- * have not been called the expected number of times.
163
- *
164
- * ```js
165
- * import assert from 'node:assert';
166
- *
167
- * // Creates call tracker.
168
- * const tracker = new assert.CallTracker();
169
- *
170
- * function func() {}
171
- *
172
- * // Returns a function that wraps func() that must be called exact times
173
- * // before tracker.verify().
174
- * const callsfunc = tracker.calls(func, 2);
175
- *
176
- * callsfunc();
177
- *
178
- * // Will throw an error since callsfunc() was only called once.
179
- * tracker.verify();
180
- * ```
181
- * @since v14.2.0, v12.19.0
182
- */
183
- verify(): void;
184
- }
185
- interface CallTrackerCall {
186
- thisArg: object;
187
- arguments: unknown[];
188
- }
189
- interface CallTrackerReportInformation {
190
- message: string;
191
- /** The actual number of times the function was called. */
192
- actual: number;
193
- /** The number of times the function was expected to be called. */
194
- expected: number;
195
- /** The name of the function that is wrapped. */
196
- operator: string;
197
- /** A stack trace of the function. */
198
- stack: object;
199
- }
200
- type AssertPredicate = RegExp | (new() => object) | ((thrown: unknown) => boolean) | object | Error;
201
- /**
202
- * Throws an `AssertionError` with the provided error message or a default
203
- * error message. If the `message` parameter is an instance of an `Error` then
204
- * it will be thrown instead of the `AssertionError`.
205
- *
206
- * ```js
207
- * import assert from 'node:assert/strict';
208
- *
209
- * assert.fail();
210
- * // AssertionError [ERR_ASSERTION]: Failed
211
- *
212
- * assert.fail('boom');
213
- * // AssertionError [ERR_ASSERTION]: boom
214
- *
215
- * assert.fail(new TypeError('need array'));
216
- * // TypeError: need array
217
- * ```
218
- *
219
- * Using `assert.fail()` with more than two arguments is possible but deprecated.
220
- * See below for further details.
221
- * @since v0.1.21
222
- * @param [message='Failed']
223
- */
224
- function fail(message?: string | Error): never;
225
- /** @deprecated since v10.0.0 - use fail([message]) or other assert functions instead. */
226
- function fail(
227
- actual: unknown,
228
- expected: unknown,
229
- message?: string | Error,
230
- operator?: string,
231
- // eslint-disable-next-line @typescript-eslint/ban-types
232
- stackStartFn?: Function,
233
- ): never;
234
- /**
235
- * Tests if `value` is truthy. It is equivalent to`assert.equal(!!value, true, message)`.
236
- *
237
- * If `value` is not truthy, an `AssertionError` is thrown with a `message`property set equal to the value of the `message` parameter. If the `message`parameter is `undefined`, a default
238
- * error message is assigned. If the `message`parameter is an instance of an `Error` then it will be thrown instead of the`AssertionError`.
239
- * If no arguments are passed in at all `message` will be set to the string:`` 'No value argument passed to `assert.ok()`' ``.
240
- *
241
- * Be aware that in the `repl` the error message will be different to the one
242
- * thrown in a file! See below for further details.
243
- *
244
- * ```js
245
- * import assert from 'node:assert/strict';
246
- *
247
- * assert.ok(true);
248
- * // OK
249
- * assert.ok(1);
250
- * // OK
251
- *
252
- * assert.ok();
253
- * // AssertionError: No value argument passed to `assert.ok()`
254
- *
255
- * assert.ok(false, 'it\'s false');
256
- * // AssertionError: it's false
257
- *
258
- * // In the repl:
259
- * assert.ok(typeof 123 === 'string');
260
- * // AssertionError: false == true
261
- *
262
- * // In a file (e.g. test.js):
263
- * assert.ok(typeof 123 === 'string');
264
- * // AssertionError: The expression evaluated to a falsy value:
265
- * //
266
- * // assert.ok(typeof 123 === 'string')
267
- *
268
- * assert.ok(false);
269
- * // AssertionError: The expression evaluated to a falsy value:
270
- * //
271
- * // assert.ok(false)
272
- *
273
- * assert.ok(0);
274
- * // AssertionError: The expression evaluated to a falsy value:
275
- * //
276
- * // assert.ok(0)
277
- * ```
278
- *
279
- * ```js
280
- * import assert from 'node:assert/strict';
281
- *
282
- * // Using `assert()` works the same:
283
- * assert(0);
284
- * // AssertionError: The expression evaluated to a falsy value:
285
- * //
286
- * // assert(0)
287
- * ```
288
- * @since v0.1.21
289
- */
290
- function ok(value: unknown, message?: string | Error): asserts value;
291
- /**
292
- * **Strict assertion mode**
293
- *
294
- * An alias of {@link strictEqual}.
295
- *
296
- * **Legacy assertion mode**
297
- *
298
- * > Stability: 3 - Legacy: Use {@link strictEqual} instead.
299
- *
300
- * Tests shallow, coercive equality between the `actual` and `expected` parameters
301
- * using the [`==` operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality). `NaN` is specially handled
302
- * and treated as being identical if both sides are `NaN`.
303
- *
304
- * ```js
305
- * import assert from 'node:assert';
306
- *
307
- * assert.equal(1, 1);
308
- * // OK, 1 == 1
309
- * assert.equal(1, '1');
310
- * // OK, 1 == '1'
311
- * assert.equal(NaN, NaN);
312
- * // OK
313
- *
314
- * assert.equal(1, 2);
315
- * // AssertionError: 1 == 2
316
- * assert.equal({ a: { b: 1 } }, { a: { b: 1 } });
317
- * // AssertionError: { a: { b: 1 } } == { a: { b: 1 } }
318
- * ```
319
- *
320
- * If the values are not equal, an `AssertionError` is thrown with a `message`property set equal to the value of the `message` parameter. If the `message`parameter is undefined, a default
321
- * error message is assigned. If the `message`parameter is an instance of an `Error` then it will be thrown instead of the`AssertionError`.
322
- * @since v0.1.21
323
- */
324
- function equal(actual: unknown, expected: unknown, message?: string | Error): void;
325
- /**
326
- * **Strict assertion mode**
327
- *
328
- * An alias of {@link notStrictEqual}.
329
- *
330
- * **Legacy assertion mode**
331
- *
332
- * > Stability: 3 - Legacy: Use {@link notStrictEqual} instead.
333
- *
334
- * Tests shallow, coercive inequality with the [`!=` operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Inequality). `NaN` is
335
- * specially handled and treated as being identical if both sides are `NaN`.
336
- *
337
- * ```js
338
- * import assert from 'node:assert';
339
- *
340
- * assert.notEqual(1, 2);
341
- * // OK
342
- *
343
- * assert.notEqual(1, 1);
344
- * // AssertionError: 1 != 1
345
- *
346
- * assert.notEqual(1, '1');
347
- * // AssertionError: 1 != '1'
348
- * ```
349
- *
350
- * If the values are equal, an `AssertionError` is thrown with a `message`property set equal to the value of the `message` parameter. If the `message`parameter is undefined, a default error
351
- * message is assigned. If the `message`parameter is an instance of an `Error` then it will be thrown instead of the`AssertionError`.
352
- * @since v0.1.21
353
- */
354
- function notEqual(actual: unknown, expected: unknown, message?: string | Error): void;
355
- /**
356
- * **Strict assertion mode**
357
- *
358
- * An alias of {@link deepStrictEqual}.
359
- *
360
- * **Legacy assertion mode**
361
- *
362
- * > Stability: 3 - Legacy: Use {@link deepStrictEqual} instead.
363
- *
364
- * Tests for deep equality between the `actual` and `expected` parameters. Consider
365
- * using {@link deepStrictEqual} instead. {@link deepEqual} can have
366
- * surprising results.
367
- *
368
- * _Deep equality_ means that the enumerable "own" properties of child objects
369
- * are also recursively evaluated by the following rules.
370
- * @since v0.1.21
371
- */
372
- function deepEqual(actual: unknown, expected: unknown, message?: string | Error): void;
373
- /**
374
- * **Strict assertion mode**
375
- *
376
- * An alias of {@link notDeepStrictEqual}.
377
- *
378
- * **Legacy assertion mode**
379
- *
380
- * > Stability: 3 - Legacy: Use {@link notDeepStrictEqual} instead.
381
- *
382
- * Tests for any deep inequality. Opposite of {@link deepEqual}.
383
- *
384
- * ```js
385
- * import assert from 'node:assert';
386
- *
387
- * const obj1 = {
388
- * a: {
389
- * b: 1,
390
- * },
391
- * };
392
- * const obj2 = {
393
- * a: {
394
- * b: 2,
395
- * },
396
- * };
397
- * const obj3 = {
398
- * a: {
399
- * b: 1,
400
- * },
401
- * };
402
- * const obj4 = { __proto__: obj1 };
403
- *
404
- * assert.notDeepEqual(obj1, obj1);
405
- * // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } }
406
- *
407
- * assert.notDeepEqual(obj1, obj2);
408
- * // OK
409
- *
410
- * assert.notDeepEqual(obj1, obj3);
411
- * // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } }
412
- *
413
- * assert.notDeepEqual(obj1, obj4);
414
- * // OK
415
- * ```
416
- *
417
- * If the values are deeply equal, an `AssertionError` is thrown with a`message` property set equal to the value of the `message` parameter. If the`message` parameter is undefined, a default
418
- * error message is assigned. If the`message` parameter is an instance of an `Error` then it will be thrown
419
- * instead of the `AssertionError`.
420
- * @since v0.1.21
421
- */
422
- function notDeepEqual(actual: unknown, expected: unknown, message?: string | Error): void;
423
- /**
424
- * Tests strict equality between the `actual` and `expected` parameters as
425
- * determined by [`Object.is()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is).
426
- *
427
- * ```js
428
- * import assert from 'node:assert/strict';
429
- *
430
- * assert.strictEqual(1, 2);
431
- * // AssertionError [ERR_ASSERTION]: Expected inputs to be strictly equal:
432
- * //
433
- * // 1 !== 2
434
- *
435
- * assert.strictEqual(1, 1);
436
- * // OK
437
- *
438
- * assert.strictEqual('Hello foobar', 'Hello World!');
439
- * // AssertionError [ERR_ASSERTION]: Expected inputs to be strictly equal:
440
- * // + actual - expected
441
- * //
442
- * // + 'Hello foobar'
443
- * // - 'Hello World!'
444
- * // ^
445
- *
446
- * const apples = 1;
447
- * const oranges = 2;
448
- * assert.strictEqual(apples, oranges, `apples ${apples} !== oranges ${oranges}`);
449
- * // AssertionError [ERR_ASSERTION]: apples 1 !== oranges 2
450
- *
451
- * assert.strictEqual(1, '1', new TypeError('Inputs are not identical'));
452
- * // TypeError: Inputs are not identical
453
- * ```
454
- *
455
- * If the values are not strictly equal, an `AssertionError` is thrown with a`message` property set equal to the value of the `message` parameter. If the`message` parameter is undefined, a
456
- * default error message is assigned. If the`message` parameter is an instance of an `Error` then it will be thrown
457
- * instead of the `AssertionError`.
458
- * @since v0.1.21
459
- */
460
- function strictEqual<T>(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
461
- /**
462
- * Tests strict inequality between the `actual` and `expected` parameters as
463
- * determined by [`Object.is()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is).
464
- *
465
- * ```js
466
- * import assert from 'node:assert/strict';
467
- *
468
- * assert.notStrictEqual(1, 2);
469
- * // OK
470
- *
471
- * assert.notStrictEqual(1, 1);
472
- * // AssertionError [ERR_ASSERTION]: Expected "actual" to be strictly unequal to:
473
- * //
474
- * // 1
475
- *
476
- * assert.notStrictEqual(1, '1');
477
- * // OK
478
- * ```
479
- *
480
- * If the values are strictly equal, an `AssertionError` is thrown with a`message` property set equal to the value of the `message` parameter. If the`message` parameter is undefined, a
481
- * default error message is assigned. If the`message` parameter is an instance of an `Error` then it will be thrown
482
- * instead of the `AssertionError`.
483
- * @since v0.1.21
484
- */
485
- function notStrictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
486
- /**
487
- * Tests for deep equality between the `actual` and `expected` parameters.
488
- * "Deep" equality means that the enumerable "own" properties of child objects
489
- * are recursively evaluated also by the following rules.
490
- * @since v1.2.0
491
- */
492
- function deepStrictEqual<T>(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
493
- /**
494
- * Tests for deep strict inequality. Opposite of {@link deepStrictEqual}.
495
- *
496
- * ```js
497
- * import assert from 'node:assert/strict';
498
- *
499
- * assert.notDeepStrictEqual({ a: 1 }, { a: '1' });
500
- * // OK
501
- * ```
502
- *
503
- * If the values are deeply and strictly equal, an `AssertionError` is thrown
504
- * with a `message` property set equal to the value of the `message` parameter. If
505
- * the `message` parameter is undefined, a default error message is assigned. If
506
- * the `message` parameter is an instance of an `Error` then it will be thrown
507
- * instead of the `AssertionError`.
508
- * @since v1.2.0
509
- */
510
- function notDeepStrictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
511
- /**
512
- * Expects the function `fn` to throw an error.
513
- *
514
- * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
515
- * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), a validation function,
516
- * a validation object where each property will be tested for strict deep equality,
517
- * or an instance of error where each property will be tested for strict deep
518
- * equality including the non-enumerable `message` and `name` properties. When
519
- * using an object, it is also possible to use a regular expression, when
520
- * validating against a string property. See below for examples.
521
- *
522
- * If specified, `message` will be appended to the message provided by the`AssertionError` if the `fn` call fails to throw or in case the error validation
523
- * fails.
524
- *
525
- * Custom validation object/error instance:
526
- *
527
- * ```js
528
- * import assert from 'node:assert/strict';
529
- *
530
- * const err = new TypeError('Wrong value');
531
- * err.code = 404;
532
- * err.foo = 'bar';
533
- * err.info = {
534
- * nested: true,
535
- * baz: 'text',
536
- * };
537
- * err.reg = /abc/i;
538
- *
539
- * assert.throws(
540
- * () => {
541
- * throw err;
542
- * },
543
- * {
544
- * name: 'TypeError',
545
- * message: 'Wrong value',
546
- * info: {
547
- * nested: true,
548
- * baz: 'text',
549
- * },
550
- * // Only properties on the validation object will be tested for.
551
- * // Using nested objects requires all properties to be present. Otherwise
552
- * // the validation is going to fail.
553
- * },
554
- * );
555
- *
556
- * // Using regular expressions to validate error properties:
557
- * assert.throws(
558
- * () => {
559
- * throw err;
560
- * },
561
- * {
562
- * // The `name` and `message` properties are strings and using regular
563
- * // expressions on those will match against the string. If they fail, an
564
- * // error is thrown.
565
- * name: /^TypeError$/,
566
- * message: /Wrong/,
567
- * foo: 'bar',
568
- * info: {
569
- * nested: true,
570
- * // It is not possible to use regular expressions for nested properties!
571
- * baz: 'text',
572
- * },
573
- * // The `reg` property contains a regular expression and only if the
574
- * // validation object contains an identical regular expression, it is going
575
- * // to pass.
576
- * reg: /abc/i,
577
- * },
578
- * );
579
- *
580
- * // Fails due to the different `message` and `name` properties:
581
- * assert.throws(
582
- * () => {
583
- * const otherErr = new Error('Not found');
584
- * // Copy all enumerable properties from `err` to `otherErr`.
585
- * for (const [key, value] of Object.entries(err)) {
586
- * otherErr[key] = value;
587
- * }
588
- * throw otherErr;
589
- * },
590
- * // The error's `message` and `name` properties will also be checked when using
591
- * // an error as validation object.
592
- * err,
593
- * );
594
- * ```
595
- *
596
- * Validate instanceof using constructor:
597
- *
598
- * ```js
599
- * import assert from 'node:assert/strict';
600
- *
601
- * assert.throws(
602
- * () => {
603
- * throw new Error('Wrong value');
604
- * },
605
- * Error,
606
- * );
607
- * ```
608
- *
609
- * Validate error message using [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions):
610
- *
611
- * Using a regular expression runs `.toString` on the error object, and will
612
- * therefore also include the error name.
613
- *
614
- * ```js
615
- * import assert from 'node:assert/strict';
616
- *
617
- * assert.throws(
618
- * () => {
619
- * throw new Error('Wrong value');
620
- * },
621
- * /^Error: Wrong value$/,
622
- * );
623
- * ```
624
- *
625
- * Custom error validation:
626
- *
627
- * The function must return `true` to indicate all internal validations passed.
628
- * It will otherwise fail with an `AssertionError`.
629
- *
630
- * ```js
631
- * import assert from 'node:assert/strict';
632
- *
633
- * assert.throws(
634
- * () => {
635
- * throw new Error('Wrong value');
636
- * },
637
- * (err) => {
638
- * assert(err instanceof Error);
639
- * assert(/value/.test(err));
640
- * // Avoid returning anything from validation functions besides `true`.
641
- * // Otherwise, it's not clear what part of the validation failed. Instead,
642
- * // throw an error about the specific validation that failed (as done in this
643
- * // example) and add as much helpful debugging information to that error as
644
- * // possible.
645
- * return true;
646
- * },
647
- * 'unexpected error',
648
- * );
649
- * ```
650
- *
651
- * `error` cannot be a string. If a string is provided as the second
652
- * argument, then `error` is assumed to be omitted and the string will be used for`message` instead. This can lead to easy-to-miss mistakes. Using the same
653
- * message as the thrown error message is going to result in an`ERR_AMBIGUOUS_ARGUMENT` error. Please read the example below carefully if using
654
- * a string as the second argument gets considered:
655
- *
656
- * ```js
657
- * import assert from 'node:assert/strict';
658
- *
659
- * function throwingFirst() {
660
- * throw new Error('First');
661
- * }
662
- *
663
- * function throwingSecond() {
664
- * throw new Error('Second');
665
- * }
666
- *
667
- * function notThrowing() {}
668
- *
669
- * // The second argument is a string and the input function threw an Error.
670
- * // The first case will not throw as it does not match for the error message
671
- * // thrown by the input function!
672
- * assert.throws(throwingFirst, 'Second');
673
- * // In the next example the message has no benefit over the message from the
674
- * // error and since it is not clear if the user intended to actually match
675
- * // against the error message, Node.js throws an `ERR_AMBIGUOUS_ARGUMENT` error.
676
- * assert.throws(throwingSecond, 'Second');
677
- * // TypeError [ERR_AMBIGUOUS_ARGUMENT]
678
- *
679
- * // The string is only used (as message) in case the function does not throw:
680
- * assert.throws(notThrowing, 'Second');
681
- * // AssertionError [ERR_ASSERTION]: Missing expected exception: Second
682
- *
683
- * // If it was intended to match for the error message do this instead:
684
- * // It does not throw because the error messages match.
685
- * assert.throws(throwingSecond, /Second$/);
686
- *
687
- * // If the error message does not match, an AssertionError is thrown.
688
- * assert.throws(throwingFirst, /Second$/);
689
- * // AssertionError [ERR_ASSERTION]
690
- * ```
691
- *
692
- * Due to the confusing error-prone notation, avoid a string as the second
693
- * argument.
694
- * @since v0.1.21
695
- */
696
- function throws(block: () => unknown, message?: string | Error): void;
697
- function throws(block: () => unknown, error: AssertPredicate, message?: string | Error): void;
698
- /**
699
- * Asserts that the function `fn` does not throw an error.
700
- *
701
- * Using `assert.doesNotThrow()` is actually not useful because there
702
- * is no benefit in catching an error and then rethrowing it. Instead, consider
703
- * adding a comment next to the specific code path that should not throw and keep
704
- * error messages as expressive as possible.
705
- *
706
- * When `assert.doesNotThrow()` is called, it will immediately call the `fn`function.
707
- *
708
- * If an error is thrown and it is the same type as that specified by the `error`parameter, then an `AssertionError` is thrown. If the error is of a
709
- * different type, or if the `error` parameter is undefined, the error is
710
- * propagated back to the caller.
711
- *
712
- * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
713
- * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), or a validation
714
- * function. See {@link throws} for more details.
715
- *
716
- * The following, for instance, will throw the `TypeError` because there is no
717
- * matching error type in the assertion:
718
- *
719
- * ```js
720
- * import assert from 'node:assert/strict';
721
- *
722
- * assert.doesNotThrow(
723
- * () => {
724
- * throw new TypeError('Wrong value');
725
- * },
726
- * SyntaxError,
727
- * );
728
- * ```
729
- *
730
- * However, the following will result in an `AssertionError` with the message
731
- * 'Got unwanted exception...':
732
- *
733
- * ```js
734
- * import assert from 'node:assert/strict';
735
- *
736
- * assert.doesNotThrow(
737
- * () => {
738
- * throw new TypeError('Wrong value');
739
- * },
740
- * TypeError,
741
- * );
742
- * ```
743
- *
744
- * If an `AssertionError` is thrown and a value is provided for the `message`parameter, the value of `message` will be appended to the `AssertionError` message:
745
- *
746
- * ```js
747
- * import assert from 'node:assert/strict';
748
- *
749
- * assert.doesNotThrow(
750
- * () => {
751
- * throw new TypeError('Wrong value');
752
- * },
753
- * /Wrong value/,
754
- * 'Whoops',
755
- * );
756
- * // Throws: AssertionError: Got unwanted exception: Whoops
757
- * ```
758
- * @since v0.1.21
759
- */
760
- function doesNotThrow(block: () => unknown, message?: string | Error): void;
761
- function doesNotThrow(block: () => unknown, error: AssertPredicate, message?: string | Error): void;
762
- /**
763
- * Throws `value` if `value` is not `undefined` or `null`. This is useful when
764
- * testing the `error` argument in callbacks. The stack trace contains all frames
765
- * from the error passed to `ifError()` including the potential new frames for`ifError()` itself.
766
- *
767
- * ```js
768
- * import assert from 'node:assert/strict';
769
- *
770
- * assert.ifError(null);
771
- * // OK
772
- * assert.ifError(0);
773
- * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: 0
774
- * assert.ifError('error');
775
- * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: 'error'
776
- * assert.ifError(new Error());
777
- * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: Error
778
- *
779
- * // Create some random error frames.
780
- * let err;
781
- * (function errorFrame() {
782
- * err = new Error('test error');
783
- * })();
784
- *
785
- * (function ifErrorFrame() {
786
- * assert.ifError(err);
787
- * })();
788
- * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: test error
789
- * // at ifErrorFrame
790
- * // at errorFrame
791
- * ```
792
- * @since v0.1.97
793
- */
794
- function ifError(value: unknown): asserts value is null | undefined;
795
- /**
796
- * Awaits the `asyncFn` promise or, if `asyncFn` is a function, immediately
797
- * calls the function and awaits the returned promise to complete. It will then
798
- * check that the promise is rejected.
799
- *
800
- * If `asyncFn` is a function and it throws an error synchronously,`assert.rejects()` will return a rejected `Promise` with that error. If the
801
- * function does not return a promise, `assert.rejects()` will return a rejected`Promise` with an `ERR_INVALID_RETURN_VALUE` error. In both cases the error
802
- * handler is skipped.
803
- *
804
- * Besides the async nature to await the completion behaves identically to {@link throws}.
805
- *
806
- * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
807
- * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), a validation function,
808
- * an object where each property will be tested for, or an instance of error where
809
- * each property will be tested for including the non-enumerable `message` and`name` properties.
810
- *
811
- * If specified, `message` will be the message provided by the `AssertionError` if the `asyncFn` fails to reject.
812
- *
813
- * ```js
814
- * import assert from 'node:assert/strict';
815
- *
816
- * await assert.rejects(
817
- * async () => {
818
- * throw new TypeError('Wrong value');
819
- * },
820
- * {
821
- * name: 'TypeError',
822
- * message: 'Wrong value',
823
- * },
824
- * );
825
- * ```
826
- *
827
- * ```js
828
- * import assert from 'node:assert/strict';
829
- *
830
- * await assert.rejects(
831
- * async () => {
832
- * throw new TypeError('Wrong value');
833
- * },
834
- * (err) => {
835
- * assert.strictEqual(err.name, 'TypeError');
836
- * assert.strictEqual(err.message, 'Wrong value');
837
- * return true;
838
- * },
839
- * );
840
- * ```
841
- *
842
- * ```js
843
- * import assert from 'node:assert/strict';
844
- *
845
- * assert.rejects(
846
- * Promise.reject(new Error('Wrong value')),
847
- * Error,
848
- * ).then(() => {
849
- * // ...
850
- * });
851
- * ```
852
- *
853
- * `error` cannot be a string. If a string is provided as the second
854
- * argument, then `error` is assumed to be omitted and the string will be used for`message` instead. This can lead to easy-to-miss mistakes. Please read the
855
- * example in {@link throws} carefully if using a string as the second
856
- * argument gets considered.
857
- * @since v10.0.0
858
- */
859
- function rejects(block: (() => Promise<unknown>) | Promise<unknown>, message?: string | Error): Promise<void>;
860
- function rejects(
861
- block: (() => Promise<unknown>) | Promise<unknown>,
862
- error: AssertPredicate,
863
- message?: string | Error,
864
- ): Promise<void>;
865
- /**
866
- * Awaits the `asyncFn` promise or, if `asyncFn` is a function, immediately
867
- * calls the function and awaits the returned promise to complete. It will then
868
- * check that the promise is not rejected.
869
- *
870
- * If `asyncFn` is a function and it throws an error synchronously,`assert.doesNotReject()` will return a rejected `Promise` with that error. If
871
- * the function does not return a promise, `assert.doesNotReject()` will return a
872
- * rejected `Promise` with an `ERR_INVALID_RETURN_VALUE` error. In both cases
873
- * the error handler is skipped.
874
- *
875
- * Using `assert.doesNotReject()` is actually not useful because there is little
876
- * benefit in catching a rejection and then rejecting it again. Instead, consider
877
- * adding a comment next to the specific code path that should not reject and keep
878
- * error messages as expressive as possible.
879
- *
880
- * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
881
- * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), or a validation
882
- * function. See {@link throws} for more details.
883
- *
884
- * Besides the async nature to await the completion behaves identically to {@link doesNotThrow}.
885
- *
886
- * ```js
887
- * import assert from 'node:assert/strict';
888
- *
889
- * await assert.doesNotReject(
890
- * async () => {
891
- * throw new TypeError('Wrong value');
892
- * },
893
- * SyntaxError,
894
- * );
895
- * ```
896
- *
897
- * ```js
898
- * import assert from 'node:assert/strict';
899
- *
900
- * assert.doesNotReject(Promise.reject(new TypeError('Wrong value')))
901
- * .then(() => {
902
- * // ...
903
- * });
904
- * ```
905
- * @since v10.0.0
906
- */
907
- function doesNotReject(
908
- block: (() => Promise<unknown>) | Promise<unknown>,
909
- message?: string | Error,
910
- ): Promise<void>;
911
- function doesNotReject(
912
- block: (() => Promise<unknown>) | Promise<unknown>,
913
- error: AssertPredicate,
914
- message?: string | Error,
915
- ): Promise<void>;
916
- /**
917
- * Expects the `string` input to match the regular expression.
918
- *
919
- * ```js
920
- * import assert from 'node:assert/strict';
921
- *
922
- * assert.match('I will fail', /pass/);
923
- * // AssertionError [ERR_ASSERTION]: The input did not match the regular ...
924
- *
925
- * assert.match(123, /pass/);
926
- * // AssertionError [ERR_ASSERTION]: The "string" argument must be of type string.
927
- *
928
- * assert.match('I will pass', /pass/);
929
- * // OK
930
- * ```
931
- *
932
- * If the values do not match, or if the `string` argument is of another type than`string`, an `AssertionError` is thrown with a `message` property set equal
933
- * to the value of the `message` parameter. If the `message` parameter is
934
- * undefined, a default error message is assigned. If the `message` parameter is an
935
- * instance of an `Error` then it will be thrown instead of the `AssertionError`.
936
- * @since v13.6.0, v12.16.0
937
- */
938
- function match(value: string, regExp: RegExp, message?: string | Error): void;
939
- /**
940
- * Expects the `string` input not to match the regular expression.
941
- *
942
- * ```js
943
- * import assert from 'node:assert/strict';
944
- *
945
- * assert.doesNotMatch('I will fail', /fail/);
946
- * // AssertionError [ERR_ASSERTION]: The input was expected to not match the ...
947
- *
948
- * assert.doesNotMatch(123, /pass/);
949
- * // AssertionError [ERR_ASSERTION]: The "string" argument must be of type string.
950
- *
951
- * assert.doesNotMatch('I will pass', /different/);
952
- * // OK
953
- * ```
954
- *
955
- * If the values do match, or if the `string` argument is of another type than`string`, an `AssertionError` is thrown with a `message` property set equal
956
- * to the value of the `message` parameter. If the `message` parameter is
957
- * undefined, a default error message is assigned. If the `message` parameter is an
958
- * instance of an `Error` then it will be thrown instead of the `AssertionError`.
959
- * @since v13.6.0, v12.16.0
960
- */
961
- function doesNotMatch(value: string, regExp: RegExp, message?: string | Error): void;
962
- const strict:
963
- & Omit<
964
- typeof assert,
965
- | "equal"
966
- | "notEqual"
967
- | "deepEqual"
968
- | "notDeepEqual"
969
- | "ok"
970
- | "strictEqual"
971
- | "deepStrictEqual"
972
- | "ifError"
973
- | "strict"
974
- >
975
- & {
976
- (value: unknown, message?: string | Error): asserts value;
977
- equal: typeof strictEqual;
978
- notEqual: typeof notStrictEqual;
979
- deepEqual: typeof deepStrictEqual;
980
- notDeepEqual: typeof notDeepStrictEqual;
981
- // Mapped types and assertion functions are incompatible?
982
- // TS2775: Assertions require every name in the call target
983
- // to be declared with an explicit type annotation.
984
- ok: typeof ok;
985
- strictEqual: typeof strictEqual;
986
- deepStrictEqual: typeof deepStrictEqual;
987
- ifError: typeof ifError;
988
- strict: typeof strict;
989
- };
990
- }
991
- export = assert;
992
- }
993
- declare module "node:assert" {
994
- import assert = require("assert");
995
- export = assert;
996
- }