[Streams API] Shield streams against user replacing the Promise constructor
[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 newQueue()
94 {
95     return { content: [], size: 0 };
96 }
97
98 function dequeueValue(queue)
99 {
100     "use strict";
101
102     var record = queue.content.shift();
103     queue.size -= record.size;
104     return record.value;
105 }
106
107 function enqueueValueWithSize(queue, value, size)
108 {
109     size = Number(size);
110     if (Number.isNaN(size) || !Number.isFinite(size) || size < 0)
111         throw new @RangeError("size has an incorrect value");
112     queue.content.push({ value: value, size: size });
113     queue.size += size;
114
115     return undefined;
116 }
117
118 function peekQueueValue(queue)
119 {
120     // FIXME
121     // assert(queue.content.length > 0);
122
123     return queue.content[0].value;
124 }