498d4f8869c7b4b11555b98a9a67b70caaaa160a
[WebKit-https.git] / Source / WebCore / Modules / mediastream / RTCPeerConnectionInternals.js
1 /*
2  * Copyright (C) 2015, 2016 Ericsson AB. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
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
12  *    in the documentation and/or other materials provided with the
13  *    distribution.
14  * 3. Neither the name of Ericsson nor the names of its contributors
15  *    may be used to endorse or promote products derived from this
16  *    software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30
31 // @conditional=ENABLE(WEB_RTC)
32 // @internal
33
34 // Operation queue as specified in section 4.3.1 (WebRTC 1.0)
35 function enqueueOperation(peerConnection, operation)
36 {
37     "use strict";
38
39     const operations = peerConnection.@operations;
40
41     function runNext() {
42         operations.@shift();
43         if (operations.length)
44             operations[0]();
45     };
46
47     return new @Promise(function (resolve, reject) {
48         operations.@push(function() {
49             operation().@then(resolve, reject).@then(runNext, runNext);
50         });
51
52         if (operations.length == 1)
53             operations[0]();
54     });
55 }
56
57 function objectAndCallbacksOverload(args, functionName, objectInfo, promiseMode, legacyMode)
58 {
59     "use strict";
60
61     let argsCount = args.length;
62     let objectArg = args[0];
63     let objectArgOk = false;
64
65     if (!argsCount) {
66         if (!objectInfo.defaultsToNull)
67             return @Promise.@reject(new @TypeError("Not enough arguments"));
68
69         objectArg = null;
70         objectArgOk = true;
71         argsCount = 1;
72     } else {
73         const hasMatchingType = objectArg instanceof objectInfo.constructor;
74         if (hasMatchingType)
75             objectArgOk = true;
76         else if (objectInfo.defaultsToNull)
77             objectArgOk = objectArg === null || typeof objectArg === "undefined";
78         else if (objectInfo.maybeDictionary) {
79             try {
80                 objectArg = new objectInfo.constructor(objectArg);
81                 objectArgOk = true;
82             } catch (e) {
83                 objectArgOk = false;
84             }
85         }
86     }
87
88     if (!objectArgOk)
89         return @Promise.@reject(new @TypeError(`Argument 1 ('${objectInfo.argName}') to RTCPeerConnection.${functionName} must be an instance of ${objectInfo.argType}`));
90
91     if (argsCount === 1)
92         return promiseMode(objectArg);
93
94     // More than one argument: Legacy mode
95     if (argsCount < 3)
96         return @Promise.@reject(new @TypeError("Not enough arguments"));
97
98     const successCallback = args[1];
99     const errorCallback = args[2];
100
101     if (typeof successCallback !== "function")
102         return @Promise.@reject(new @TypeError(`Argument 2 ('successCallback') to RTCPeerConnection.${functionName} must be a function`));
103
104     if (typeof errorCallback !== "function")
105         return @Promise.@reject(new @TypeError(`Argument 3 ('errorCallback') to RTCPeerConnection.${functionName} must be a function`));
106
107     return legacyMode(objectArg, successCallback, errorCallback);
108 }
109
110 function callbacksAndDictionaryOverload(args, functionName, promiseMode, legacyMode)
111 {
112     "use strict";
113
114     if (args.length <= 1) {
115         // Zero or one arguments: Promise mode
116         const options = args[0];
117         if (args.length && !@isDictionary(options))
118             return @Promise.@reject(new @TypeError(`Argument 1 ('options') to RTCPeerConnection.${functionName} must be a dictionary`));
119
120         return promiseMode(options);
121     }
122
123     // More than one argument: Legacy mode
124     const successCallback = args[0];
125     const errorCallback = args[1];
126     const options = args[2];
127
128     if (typeof successCallback !== "function")
129         return @Promise.@reject(new @TypeError(`Argument 1 ('successCallback') to RTCPeerConnection.${functionName} must be a function`));
130
131     if (typeof errorCallback !== "function")
132         return @Promise.@reject(new @TypeError(`Argument 2 ('errorCallback') to RTCPeerConnection.${functionName} must be a function`));
133
134     if (args.length > 2 && !@isDictionary(options))
135         return @Promise.@reject(new @TypeError(`Argument 3 ('options') to RTCPeerConnection.${functionName} must be a dictionary`));
136
137     return legacyMode(successCallback, errorCallback, args[2]);
138 }
139
140 function isRTCPeerConnection(connection)
141 {
142     "use strict";
143
144     return @isObject(connection) && !!connection.@operations;
145 }