blob: bc1e402607b45ff6ae2e28458a192176da7fc8a4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
/*
This file is part of GNU Taler
(C) 2019 GNUnet e.V.
TALER is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation; either version 3, or (at your option) any later version.
TALER is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/>
*/
/**
* An opened promise.
*
* @see {@link openPromise}
*/
export interface OpenedPromise<T> {
promise: Promise<T>;
resolve: (val: T) => void;
reject: (err: any) => void;
lastError?: any;
}
/**
* Get an unresolved promise together with its extracted resolve / reject
* function.
*
* Recent ECMAScript proposals also call this a promise capability.
*/
export function openPromise<T>(): OpenedPromise<T> {
let resolve: ((x?: any) => void) | null = null;
let promiseReject: ((reason?: any) => void) | null = null;
const promise = new Promise<T>((res, rej) => {
resolve = res;
promiseReject = rej;
});
if (!(resolve && promiseReject)) {
// Never happens, unless JS implementation is broken
throw Error("JS implementation is broken");
}
const result: OpenedPromise<T> = { resolve, reject: promiseReject, promise };
function saveLastError(reason?: any) {
result.lastError = reason;
promiseReject!(reason);
}
result.reject = saveLastError;
return result;
}
export class AsyncCondition {
private promCap?: OpenedPromise<void> = undefined;
constructor() {}
wait(): Promise<void> {
if (!this.promCap) {
this.promCap = openPromise<void>();
}
return this.promCap.promise;
}
trigger(): void {
if (this.promCap) {
this.promCap.resolve();
}
this.promCap = undefined;
}
}
/**
* Flag that can be raised to notify asynchronous waiters.
*
* You can think of it as a promise that can
* be un-resolved.
*/
export class AsyncFlag {
private promCap?: OpenedPromise<void> = undefined;
private internalFlagRaised: boolean = false;
constructor() {}
/**
* Wait until the flag is raised.
*
* Reset if before returning.
*/
wait(): Promise<void> {
if (this.internalFlagRaised) {
return Promise.resolve();
}
if (!this.promCap) {
this.promCap = openPromise<void>();
}
return this.promCap.promise;
}
raise(): void {
this.internalFlagRaised = true;
if (this.promCap) {
this.promCap.resolve();
}
}
reset(): void {
this.internalFlagRaised = false;
this.promCap = undefined;
}
}
|