@xylabs/forget 4.13.20 → 4.13.21
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.
- package/README.md +423 -3
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -12,13 +12,433 @@
|
|
|
12
12
|
[![snyk-badge][]][snyk-link]
|
|
13
13
|
[![socket-badge][]][socket-link]
|
|
14
14
|
|
|
15
|
-
Version: 4.13.19
|
|
16
15
|
|
|
17
16
|
Base functionality used throughout XY Labs TypeScript/JavaScript libraries
|
|
18
17
|
|
|
19
|
-
## Documentation
|
|
18
|
+
## API Documentation
|
|
19
|
+
|
|
20
|
+
**@xylabs/forget**
|
|
21
|
+
|
|
22
|
+
***
|
|
23
|
+
|
|
24
|
+
## Classes
|
|
25
|
+
|
|
26
|
+
- [ForgetPromise](#classes/ForgetPromise)
|
|
27
|
+
|
|
28
|
+
## Interfaces
|
|
29
|
+
|
|
30
|
+
- [ForgetNodeConfig](#interfaces/ForgetNodeConfig)
|
|
31
|
+
|
|
32
|
+
## Variables
|
|
33
|
+
|
|
34
|
+
- [defaultForgetNodeConfig](#variables/defaultForgetNodeConfig)
|
|
35
|
+
|
|
36
|
+
## Functions
|
|
37
|
+
|
|
38
|
+
- [forget](#functions/forget)
|
|
39
|
+
|
|
40
|
+
### classes
|
|
41
|
+
|
|
42
|
+
### <a id="ForgetPromise"></a>ForgetPromise
|
|
43
|
+
|
|
44
|
+
[**@xylabs/forget**](#../README)
|
|
45
|
+
|
|
46
|
+
***
|
|
47
|
+
|
|
48
|
+
## Extends
|
|
49
|
+
|
|
50
|
+
- `ForgetPromise`
|
|
51
|
+
|
|
52
|
+
## Constructors
|
|
53
|
+
|
|
54
|
+
### Constructor
|
|
55
|
+
|
|
56
|
+
```ts
|
|
57
|
+
new ForgetPromise(): ForgetPromiseNode;
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Returns
|
|
61
|
+
|
|
62
|
+
`ForgetPromiseNode`
|
|
63
|
+
|
|
64
|
+
### Inherited from
|
|
65
|
+
|
|
66
|
+
```ts
|
|
67
|
+
ForgetPromise.constructor
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Properties
|
|
71
|
+
|
|
72
|
+
### activeForgets
|
|
73
|
+
|
|
74
|
+
```ts
|
|
75
|
+
static activeForgets: number = 0;
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Inherited from
|
|
79
|
+
|
|
80
|
+
```ts
|
|
81
|
+
ForgetPromise.activeForgets
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
***
|
|
85
|
+
|
|
86
|
+
### exceptedForgets
|
|
87
|
+
|
|
88
|
+
```ts
|
|
89
|
+
static exceptedForgets: number = 0;
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Inherited from
|
|
93
|
+
|
|
94
|
+
```ts
|
|
95
|
+
ForgetPromise.exceptedForgets
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
***
|
|
99
|
+
|
|
100
|
+
### logger
|
|
101
|
+
|
|
102
|
+
```ts
|
|
103
|
+
static logger: Logger = console;
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### Inherited from
|
|
107
|
+
|
|
108
|
+
```ts
|
|
109
|
+
ForgetPromise.logger
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
## Accessors
|
|
113
|
+
|
|
114
|
+
### active
|
|
115
|
+
|
|
116
|
+
### Get Signature
|
|
117
|
+
|
|
118
|
+
```ts
|
|
119
|
+
get static active(): boolean;
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
#### Returns
|
|
123
|
+
|
|
124
|
+
`boolean`
|
|
125
|
+
|
|
126
|
+
### Inherited from
|
|
127
|
+
|
|
128
|
+
```ts
|
|
129
|
+
ForgetPromise.active
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## Methods
|
|
133
|
+
|
|
134
|
+
### awaitInactive()
|
|
135
|
+
|
|
136
|
+
```ts
|
|
137
|
+
static awaitInactive(interval, timeout?): Promise<number>;
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### Parameters
|
|
141
|
+
|
|
142
|
+
#### interval
|
|
143
|
+
|
|
144
|
+
`number` = `100`
|
|
145
|
+
|
|
146
|
+
#### timeout?
|
|
147
|
+
|
|
148
|
+
`number`
|
|
149
|
+
|
|
150
|
+
### Returns
|
|
151
|
+
|
|
152
|
+
`Promise`\<`number`\>
|
|
153
|
+
|
|
154
|
+
### Inherited from
|
|
155
|
+
|
|
156
|
+
```ts
|
|
157
|
+
ForgetPromise.awaitInactive
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
***
|
|
161
|
+
|
|
162
|
+
### exceptionHandler()
|
|
163
|
+
|
|
164
|
+
```ts
|
|
165
|
+
static exceptionHandler(
|
|
166
|
+
error,
|
|
167
|
+
config,
|
|
168
|
+
externalStackTrace?): void;
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
### Parameters
|
|
172
|
+
|
|
173
|
+
#### error
|
|
174
|
+
|
|
175
|
+
`Error`
|
|
176
|
+
|
|
177
|
+
#### config
|
|
178
|
+
|
|
179
|
+
[`ForgetNodeConfig`](#../interfaces/ForgetNodeConfig)
|
|
180
|
+
|
|
181
|
+
#### externalStackTrace?
|
|
182
|
+
|
|
183
|
+
`string`
|
|
184
|
+
|
|
185
|
+
### Returns
|
|
186
|
+
|
|
187
|
+
`void`
|
|
188
|
+
|
|
189
|
+
### Overrides
|
|
190
|
+
|
|
191
|
+
```ts
|
|
192
|
+
ForgetPromise.exceptionHandler
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
***
|
|
196
|
+
|
|
197
|
+
### forget()
|
|
198
|
+
|
|
199
|
+
```ts
|
|
200
|
+
static forget<T>(promise, config?): void;
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
Used to explicitly launch an async function (or Promise) with awaiting it
|
|
204
|
+
|
|
205
|
+
### Type Parameters
|
|
206
|
+
|
|
207
|
+
#### T
|
|
208
|
+
|
|
209
|
+
`T`
|
|
210
|
+
|
|
211
|
+
### Parameters
|
|
212
|
+
|
|
213
|
+
#### promise
|
|
214
|
+
|
|
215
|
+
`Promisable`\<`T`\>
|
|
216
|
+
|
|
217
|
+
The promise to forget
|
|
218
|
+
|
|
219
|
+
#### config?
|
|
220
|
+
|
|
221
|
+
[`ForgetNodeConfig`](#../interfaces/ForgetNodeConfig)\<`T`\>
|
|
222
|
+
|
|
223
|
+
Configuration of forget settings
|
|
224
|
+
|
|
225
|
+
### Returns
|
|
226
|
+
|
|
227
|
+
`void`
|
|
228
|
+
|
|
229
|
+
### Overrides
|
|
230
|
+
|
|
231
|
+
```ts
|
|
232
|
+
ForgetPromise.forget
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
***
|
|
236
|
+
|
|
237
|
+
### timeoutHandler()
|
|
238
|
+
|
|
239
|
+
```ts
|
|
240
|
+
static timeoutHandler(
|
|
241
|
+
time,
|
|
242
|
+
config,
|
|
243
|
+
externalStackTrace?): void;
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
### Parameters
|
|
247
|
+
|
|
248
|
+
#### time
|
|
249
|
+
|
|
250
|
+
`number`
|
|
251
|
+
|
|
252
|
+
#### config
|
|
253
|
+
|
|
254
|
+
[`ForgetNodeConfig`](#../interfaces/ForgetNodeConfig)
|
|
255
|
+
|
|
256
|
+
#### externalStackTrace?
|
|
257
|
+
|
|
258
|
+
`string`
|
|
259
|
+
|
|
260
|
+
### Returns
|
|
261
|
+
|
|
262
|
+
`void`
|
|
263
|
+
|
|
264
|
+
### Overrides
|
|
265
|
+
|
|
266
|
+
```ts
|
|
267
|
+
ForgetPromise.timeoutHandler
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
### functions
|
|
271
|
+
|
|
272
|
+
### <a id="forget"></a>forget
|
|
273
|
+
|
|
274
|
+
[**@xylabs/forget**](#../README)
|
|
275
|
+
|
|
276
|
+
***
|
|
277
|
+
|
|
278
|
+
```ts
|
|
279
|
+
function forget<T>(promise, config?): void;
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
## Type Parameters
|
|
283
|
+
|
|
284
|
+
### T
|
|
285
|
+
|
|
286
|
+
`T`
|
|
287
|
+
|
|
288
|
+
## Parameters
|
|
289
|
+
|
|
290
|
+
### promise
|
|
291
|
+
|
|
292
|
+
`Promisable`\<`T`\>
|
|
293
|
+
|
|
294
|
+
### config?
|
|
295
|
+
|
|
296
|
+
[`ForgetNodeConfig`](#../interfaces/ForgetNodeConfig)\<`T`\>
|
|
297
|
+
|
|
298
|
+
## Returns
|
|
299
|
+
|
|
300
|
+
`void`
|
|
301
|
+
|
|
302
|
+
### interfaces
|
|
303
|
+
|
|
304
|
+
### <a id="ForgetNodeConfig"></a>ForgetNodeConfig
|
|
305
|
+
|
|
306
|
+
[**@xylabs/forget**](#../README)
|
|
307
|
+
|
|
308
|
+
***
|
|
309
|
+
|
|
310
|
+
## Extends
|
|
311
|
+
|
|
312
|
+
- `ForgetConfig`\<`T`\>
|
|
313
|
+
|
|
314
|
+
## Type Parameters
|
|
315
|
+
|
|
316
|
+
### T
|
|
317
|
+
|
|
318
|
+
`T` = `any`
|
|
319
|
+
|
|
320
|
+
## Properties
|
|
321
|
+
|
|
322
|
+
### name?
|
|
323
|
+
|
|
324
|
+
```ts
|
|
325
|
+
optional name: string;
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
### Inherited from
|
|
329
|
+
|
|
330
|
+
```ts
|
|
331
|
+
ForgetConfig.name
|
|
332
|
+
```
|
|
333
|
+
|
|
334
|
+
***
|
|
335
|
+
|
|
336
|
+
### onCancel()?
|
|
337
|
+
|
|
338
|
+
```ts
|
|
339
|
+
optional onCancel: () => void;
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
### Returns
|
|
343
|
+
|
|
344
|
+
`void`
|
|
345
|
+
|
|
346
|
+
### Inherited from
|
|
347
|
+
|
|
348
|
+
```ts
|
|
349
|
+
ForgetConfig.onCancel
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
***
|
|
353
|
+
|
|
354
|
+
### onComplete()?
|
|
355
|
+
|
|
356
|
+
```ts
|
|
357
|
+
optional onComplete: (result) => void;
|
|
358
|
+
```
|
|
359
|
+
|
|
360
|
+
### Parameters
|
|
361
|
+
|
|
362
|
+
#### result
|
|
363
|
+
|
|
364
|
+
\[`undefined` \| `T`, `undefined` \| `Error`\]
|
|
365
|
+
|
|
366
|
+
### Returns
|
|
367
|
+
|
|
368
|
+
`void`
|
|
369
|
+
|
|
370
|
+
### Inherited from
|
|
371
|
+
|
|
372
|
+
```ts
|
|
373
|
+
ForgetConfig.onComplete
|
|
374
|
+
```
|
|
375
|
+
|
|
376
|
+
***
|
|
377
|
+
|
|
378
|
+
### onException()?
|
|
379
|
+
|
|
380
|
+
```ts
|
|
381
|
+
optional onException: (error) => void;
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
### Parameters
|
|
385
|
+
|
|
386
|
+
#### error
|
|
387
|
+
|
|
388
|
+
`Error`
|
|
389
|
+
|
|
390
|
+
### Returns
|
|
391
|
+
|
|
392
|
+
`void`
|
|
393
|
+
|
|
394
|
+
### Inherited from
|
|
395
|
+
|
|
396
|
+
```ts
|
|
397
|
+
ForgetConfig.onException
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
***
|
|
401
|
+
|
|
402
|
+
### timeout?
|
|
403
|
+
|
|
404
|
+
```ts
|
|
405
|
+
optional timeout: number;
|
|
406
|
+
```
|
|
407
|
+
|
|
408
|
+
### Inherited from
|
|
409
|
+
|
|
410
|
+
```ts
|
|
411
|
+
ForgetConfig.timeout
|
|
412
|
+
```
|
|
413
|
+
|
|
414
|
+
***
|
|
415
|
+
|
|
416
|
+
### terminateOnException?
|
|
417
|
+
|
|
418
|
+
```ts
|
|
419
|
+
optional terminateOnException: boolean;
|
|
420
|
+
```
|
|
421
|
+
|
|
422
|
+
***
|
|
423
|
+
|
|
424
|
+
### terminateOnTimeout?
|
|
425
|
+
|
|
426
|
+
```ts
|
|
427
|
+
optional terminateOnTimeout: boolean;
|
|
428
|
+
```
|
|
429
|
+
|
|
430
|
+
### variables
|
|
431
|
+
|
|
432
|
+
### <a id="defaultForgetNodeConfig"></a>defaultForgetNodeConfig
|
|
433
|
+
|
|
434
|
+
[**@xylabs/forget**](#../README)
|
|
435
|
+
|
|
436
|
+
***
|
|
437
|
+
|
|
438
|
+
```ts
|
|
439
|
+
const defaultForgetNodeConfig: ForgetNodeConfig<unknown>;
|
|
440
|
+
```
|
|
20
441
|
|
|
21
|
-
Coming Soon!
|
|
22
442
|
|
|
23
443
|
Part of [sdk-js](https://www.npmjs.com/package/@xyo-network/sdk-js)
|
|
24
444
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xylabs/forget",
|
|
3
|
-
"version": "4.13.
|
|
3
|
+
"version": "4.13.21",
|
|
4
4
|
"description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"forget",
|
|
@@ -47,10 +47,10 @@
|
|
|
47
47
|
"src"
|
|
48
48
|
],
|
|
49
49
|
"dependencies": {
|
|
50
|
-
"@xylabs/delay": "^4.13.
|
|
51
|
-
"@xylabs/logger": "^4.13.
|
|
52
|
-
"@xylabs/promise": "^4.13.
|
|
53
|
-
"@xylabs/typeof": "^4.13.
|
|
50
|
+
"@xylabs/delay": "^4.13.21",
|
|
51
|
+
"@xylabs/logger": "^4.13.21",
|
|
52
|
+
"@xylabs/promise": "^4.13.21",
|
|
53
|
+
"@xylabs/typeof": "^4.13.21"
|
|
54
54
|
},
|
|
55
55
|
"devDependencies": {
|
|
56
56
|
"@xylabs/ts-scripts-yarn3": "^7.0.0",
|