[Streams API] Rework some readable stream internals that can be common to writable...
[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 // @optional=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 validateAndNormalizeQueuingStrategy(size, highWaterMark)
58 {
59     "use strict";
60
61     if (size !== undefined && typeof size !== "function")
62         throw new @TypeError("size parameter must be a function");
63
64     var normalizedStrategy = { };
65
66     normalizedStrategy.size = size;
67     normalizedStrategy.highWaterMark = Number(highWaterMark);
68
69     if (Number.isNaN(normalizedStrategy.highWaterMark))
70         throw new @TypeError("highWaterMark parameter is not a number");
71     if (normalizedStrategy.highWaterMark < 0)
72         throw new @RangeError("highWaterMark is negative");
73
74     return normalizedStrategy;
75 }
76
77 function createNewStreamsPromise()
78 {
79     "use strict";
80
81     var resolveFunction;
82     var rejectFunction;
83     var promise = new Promise(function(resolve, reject) {
84         resolveFunction = resolve;
85         rejectFunction = reject;
86     });
87     promise.@resolve = resolveFunction;
88     promise.@reject = rejectFunction;
89     return promise;
90 }
91
92 function resolveStreamsPromise(promise, value)
93 {
94     "use strict";
95
96     if (promise && promise.@resolve) {
97         promise.@resolve(value);
98         promise.@resolve = undefined;
99         promise.@reject = undefined;
100     }
101 }
102
103 function rejectStreamsPromise(promise, value)
104 {
105     "use strict";
106
107     if (promise && promise.@reject) {
108         promise.@reject(value);
109         promise.@resolve = undefined;
110         promise.@reject = undefined;
111     }
112 }
113
114 function newQueue()
115 {
116     return { content: [], size: 0 };
117 }
118
119 function dequeueValue(queue)
120 {
121     "use strict";
122
123     var record = queue.content.shift();
124     queue.size -= record.size;
125     return record.value;
126 }
127
128 function enqueueValueWithSize(queue, value, size)
129 {
130     size = Number(size);
131     if (Number.isNaN(size) || !Number.isFinite(size) || size < 0)
132         throw new @RangeError("size has an incorrect value");
133     queue.content.push({ value: value, size: size });
134     queue.size += size;
135
136     return undefined;
137 }