7412425e573f623b74f640d0c402eca40e9baae1
[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         objectArgOk = objectInfo.defaultsToNull ? (objectArg === null || typeof objectArg === "undefined" || hasMatchingType) : hasMatchingType;
75     }
76
77     if (!objectArgOk)
78         return @Promise.@reject(new @TypeError(`Argument 1 ('${objectInfo.argName}') to RTCPeerConnection.${functionName} must be an instance of ${objectInfo.argType}`));
79
80     if (argsCount === 1)
81         return promiseMode(objectArg);
82
83     // More than one argument: Legacy mode
84     if (argsCount < 3)
85         return @Promise.@reject(new @TypeError("Not enough arguments"));
86
87     const successCallback = args[1];
88     const errorCallback = args[2];
89
90     if (typeof successCallback !== "function")
91         return @Promise.@reject(new @TypeError(`Argument 2 ('successCallback') to RTCPeerConnection.${functionName} must be a function`));
92
93     if (typeof errorCallback !== "function")
94         return @Promise.@reject(new @TypeError(`Argument 3 ('errorCallback') to RTCPeerConnection.${functionName} must be a function`));
95
96     return legacyMode(objectArg, successCallback, errorCallback);
97 }
98
99 function callbacksAndDictionaryOverload(args, functionName, promiseMode, legacyMode)
100 {
101     "use strict";
102
103     if (args.length <= 1) {
104         // Zero or one arguments: Promise mode
105         const options = args[0];
106         if (args.length && !@isDictionary(options))
107             return @Promise.@reject(new @TypeError(`Argument 1 ('options') to RTCPeerConnection.${functionName} must be a Dictionary`));
108
109         return promiseMode(options);
110     }
111
112     // More than one argument: Legacy mode
113     const successCallback = args[0];
114     const errorCallback = args[1];
115     const options = args[2];
116
117     if (typeof successCallback !== "function")
118         return @Promise.@reject(new @TypeError(`Argument 1 ('successCallback') to RTCPeerConnection.${functionName} must be a function`));
119
120     if (typeof errorCallback !== "function")
121         return @Promise.@reject(new @TypeError(`Argument 2 ('errorCallback') to RTCPeerConnection.${functionName} must be a function`));
122
123     if (args.length > 2 && !@isDictionary(options))
124         return @Promise.@reject(new @TypeError(`Argument 3 ('options') to RTCPeerConnection.${functionName} must be a Dictionary`));
125
126     return legacyMode(successCallback, errorCallback, args[2]);
127 }
128
129 function isRTCPeerConnection(connection)
130 {
131     "use strict";
132
133     return @isObject(connection) && !!connection.@operations;
134 }