Builtins generator should emit ENABLE(FEATURE) guards based on @conditional annotation
[WebKit-https.git] / Source / WebCore / Modules / streams / StreamInternals.js
1 /*
2  * Copyright (C) 2015 Canon Inc.
3  * Copyright (C) 2015 Igalia.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26
27 // @conditional=ENABLE(STREAMS_API)
28 // @internals
29
30 function invokeOrNoop(object, key, args)
31 {
32     "use strict";
33
34     var method = object[key];
35     if (typeof method === "undefined")
36         return;
37     return method.@apply(object, args);
38 }
39
40 function promiseInvokeOrNoop(object, key, args)
41 {
42     "use strict";
43
44     try {
45         var method = object[key];
46         if (typeof method === "undefined")
47             return Promise.resolve();
48         var result = method.@apply(object, args);
49         return Promise.resolve(result);
50     }
51     catch(error) {
52         return Promise.reject(error);
53     }
54
55 }
56
57 function promiseInvokeOrFallbackOrNoop(object, key1, args1, key2, args2)
58 {
59     "use strict";
60
61     try {
62         const method = object[key1];
63         if (typeof method === "undefined")
64             return @promiseInvokeOrNoop(object, key2, args2);
65         const result = method.@apply(object, args1);
66         return Promise.resolve(result);
67     }
68     catch(error) {
69         return Promise.reject(error);
70     }
71 }
72
73 function validateAndNormalizeQueuingStrategy(size, highWaterMark)
74 {
75     "use strict";
76
77     if (size !== undefined && typeof size !== "function")
78         throw new @TypeError("size parameter must be a function");
79
80     var normalizedStrategy = { };
81
82     normalizedStrategy.size = size;
83     normalizedStrategy.highWaterMark = Number(highWaterMark);
84
85     if (Number.isNaN(normalizedStrategy.highWaterMark))
86         throw new @TypeError("highWaterMark parameter is not a number");
87     if (normalizedStrategy.highWaterMark < 0)
88         throw new @RangeError("highWaterMark is negative");
89
90     return normalizedStrategy;
91 }
92
93 function createNewStreamsPromise()
94 {
95     "use strict";
96
97     var resolveFunction;
98     var rejectFunction;
99     var promise = new Promise(function(resolve, reject) {
100         resolveFunction = resolve;
101         rejectFunction = reject;
102     });
103     promise.@resolve = resolveFunction;
104     promise.@reject = rejectFunction;
105     return promise;
106 }
107
108 function resolveStreamsPromise(promise, value)
109 {
110     "use strict";
111
112     if (promise && promise.@resolve) {
113         promise.@resolve(value);
114         promise.@resolve = undefined;
115         promise.@reject = undefined;
116     }
117 }
118
119 function rejectStreamsPromise(promise, value)
120 {
121     "use strict";
122
123     if (promise && promise.@reject) {
124         promise.@reject(value);
125         promise.@resolve = undefined;
126         promise.@reject = undefined;
127     }
128 }
129
130 function newQueue()
131 {
132     return { content: [], size: 0 };
133 }
134
135 function dequeueValue(queue)
136 {
137     "use strict";
138
139     var record = queue.content.shift();
140     queue.size -= record.size;
141     return record.value;
142 }
143
144 function enqueueValueWithSize(queue, value, size)
145 {
146     size = Number(size);
147     if (Number.isNaN(size) || !Number.isFinite(size) || size < 0)
148         throw new @RangeError("size has an incorrect value");
149     queue.content.push({ value: value, size: size });
150     queue.size += size;
151
152     return undefined;
153 }
154
155 function peekQueueValue(queue)
156 {
157     // FIXME
158     // assert(queue.content.length > 0);
159
160     return queue.content[0].value;
161 }