1 /*
2 * Copyright (c) 2021 Huawei Device Co., Ltd.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15
16 #include "ecmascript/js_iterator.h"
17
18 #include "ecmascript/interpreter/interpreter.h"
19 #include "ecmascript/js_async_from_sync_iterator.h"
20 #include "ecmascript/object_fast_operator-inl.h"
21
22 namespace panda::ecmascript {
IteratorCloseAndReturn(JSThread * thread,const JSHandle<JSTaggedValue> & iter)23 JSTaggedValue JSIterator::IteratorCloseAndReturn(JSThread *thread, const JSHandle<JSTaggedValue> &iter)
24 {
25 ASSERT(thread->HasPendingException());
26 ObjectFactory *factory = thread->GetEcmaVM()->GetFactory();
27 JSTaggedValue exception = thread->GetException();
28 JSHandle<JSTaggedValue> record = JSHandle<JSTaggedValue>(factory->NewCompletionRecord(CompletionRecordType::THROW,
29 JSHandle<JSTaggedValue>(thread, exception)));
30 JSHandle<JSTaggedValue> result = JSIterator::IteratorClose(thread, iter, record);
31 RETURN_EXCEPTION_IF_ABRUPT_COMPLETION(thread);
32 if (result->IsCompletionRecord()) {
33 return CompletionRecord::Cast(result->GetTaggedObject())->GetValue();
34 }
35 return result.GetTaggedValue();
36 }
37
GetIterator(JSThread * thread,const JSHandle<JSTaggedValue> & obj)38 JSHandle<JSTaggedValue> JSIterator::GetIterator(JSThread *thread, const JSHandle<JSTaggedValue> &obj)
39 {
40 // 1.ReturnIfAbrupt(obj).
41 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, obj);
42 // 2.If method was not passed, then
43 JSHandle<GlobalEnv> env = thread->GetEcmaVM()->GetGlobalEnv();
44 JSHandle<JSTaggedValue> iteratorSymbol = env->GetIteratorSymbol();
45 JSHandle<JSTaggedValue> func = JSObject::GetMethod(thread, obj, iteratorSymbol);
46 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, obj);
47
48 return GetIterator(thread, obj, func);
49 }
50
GetIterator(JSThread * thread,const JSHandle<JSTaggedValue> & obj,const JSHandle<JSTaggedValue> & method)51 JSHandle<JSTaggedValue> JSIterator::GetIterator(JSThread *thread, const JSHandle<JSTaggedValue> &obj,
52 const JSHandle<JSTaggedValue> &method)
53 {
54 // 1.ReturnIfAbrupt(obj).
55 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, obj);
56 // 3.Let iterator be Call(method,obj).
57 JSHandle<JSTaggedValue> undefined = thread->GlobalConstants()->GetHandledUndefined();
58 EcmaRuntimeCallInfo *info = EcmaInterpreter::NewRuntimeCallInfo(thread, method, obj, undefined, 0);
59 JSTaggedValue ret = JSFunction::Call(info);
60 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
61 JSHandle<JSTaggedValue> iter(thread, ret);
62 // 5.If Type(iterator) is not Object, throw a TypeError exception
63 if (!iter->IsECMAObject()) {
64 THROW_TYPE_ERROR_AND_RETURN(thread, "JSIterator::GetIterator: iter is not object", undefined);
65 }
66 return iter;
67 }
68
GetAsyncIterator(JSThread * thread,const JSHandle<JSTaggedValue> & obj)69 JSHandle<JSTaggedValue> JSIterator::GetAsyncIterator(JSThread *thread, const JSHandle<JSTaggedValue> &obj)
70 {
71 // 3.If method is not present, then
72 JSHandle<GlobalEnv> env = thread->GetEcmaVM()->GetGlobalEnv();
73 ObjectFactory *factory = thread->GetEcmaVM()->GetFactory();
74 JSHandle<JSTaggedValue> asynciteratorSymbol = env->GetAsyncIteratorSymbol();
75 // i. Set method to ? GetMethod(obj, @@asyncIterator).
76 // ii. If method is undefined, then
77 JSHandle<JSTaggedValue> method = JSObject::GetMethod(thread, obj, asynciteratorSymbol);
78 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, obj);
79 if (method->IsUndefined()) {
80 JSHandle<JSTaggedValue> iteratorSymbol = env->GetIteratorSymbol();
81 JSHandle<JSTaggedValue> func = JSObject::GetMethod(thread, obj, iteratorSymbol);
82 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
83 JSHandle<JSTaggedValue> syncIterator = GetIterator(thread, obj, func);
84 JSHandle<JSTaggedValue> nextStr = thread->GlobalConstants()->GetHandledNextString();
85 JSHandle<JSTaggedValue> nextMethod = JSTaggedValue::GetProperty(thread, syncIterator, nextStr).GetValue();
86 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
87 JSHandle<AsyncIteratorRecord> syncIteratorRecord =
88 factory->NewAsyncIteratorRecord(syncIterator, nextMethod, false);
89 JSHandle<JSTaggedValue> asyncIterator =
90 JSAsyncFromSyncIterator::CreateAsyncFromSyncIterator(thread, syncIteratorRecord);
91 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
92 return asyncIterator;
93 }
94
95 // 4.Let iterator be Call(method,obj).
96 JSHandle<JSTaggedValue> undefined = thread->GlobalConstants()->GetHandledUndefined();
97 EcmaRuntimeCallInfo *info = EcmaInterpreter::NewRuntimeCallInfo(thread, method, obj, undefined, 0);
98 JSTaggedValue ret = JSFunction::Call(info);
99 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
100 JSHandle<JSTaggedValue> iterator(thread, ret);
101 // 5.If Type(iterator) is not Object, throw a TypeError exception
102 if (!iterator->IsECMAObject()) {
103 THROW_TYPE_ERROR_AND_RETURN(thread, "Is not object", undefined);
104 }
105 return iterator;
106 }
107
108
109 // 7.4.2
IteratorNext(JSThread * thread,const JSHandle<JSTaggedValue> & iter)110 JSHandle<JSTaggedValue> JSIterator::IteratorNext(JSThread *thread, const JSHandle<JSTaggedValue> &iter)
111 {
112 const GlobalEnvConstants *globalConst = thread->GlobalConstants();
113
114 // 1.If value was not passed, then Let result be Invoke(iterator, "next", « »).
115 JSHandle<JSTaggedValue> key(globalConst->GetHandledNextString());
116 JSHandle<JSTaggedValue> next(JSObject::GetMethod(thread, iter, key));
117 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
118 JSHandle<JSTaggedValue> undefined = globalConst->GetHandledUndefined();
119 EcmaRuntimeCallInfo *info = EcmaInterpreter::NewRuntimeCallInfo(thread, next, iter, undefined, 0);
120 JSTaggedValue ret = JSFunction::Call(info);
121 // 3.ReturnIfAbrupt(result)
122 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, undefined);
123 // 4.If Type(result) is not Object, throw a TypeError exception.
124 if (!ret.IsECMAObject()) {
125 THROW_TYPE_ERROR_AND_RETURN(thread, "Is not Object", undefined);
126 }
127 JSHandle<JSTaggedValue> result(thread, ret);
128 return result;
129 }
130
IteratorNext(JSThread * thread,const JSHandle<JSTaggedValue> & iter,const JSHandle<JSTaggedValue> & value)131 JSHandle<JSTaggedValue> JSIterator::IteratorNext(JSThread *thread, const JSHandle<JSTaggedValue> &iter,
132 const JSHandle<JSTaggedValue> &value)
133 {
134 const GlobalEnvConstants *globalConst = thread->GlobalConstants();
135 // 2.Let result be Invoke(iterator, "next", «value»).
136 JSHandle<JSTaggedValue> key(globalConst->GetHandledNextString());
137 JSHandle<JSTaggedValue> next(JSObject::GetMethod(thread, iter, key));
138 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
139 JSHandle<JSTaggedValue> undefined = globalConst->GetHandledUndefined();
140 EcmaRuntimeCallInfo *info = EcmaInterpreter::NewRuntimeCallInfo(thread, next, iter, undefined, 1);
141 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, undefined);
142 info->SetCallArg(value.GetTaggedValue());
143 JSTaggedValue ret = JSFunction::Call(info);
144 // 3.ReturnIfAbrupt(result)
145 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, undefined);
146 // 4.If Type(result) is not Object, throw a TypeError exception.
147 if (!ret.IsECMAObject()) {
148 THROW_TYPE_ERROR_AND_RETURN(thread, "Is not Object", undefined);
149 }
150 JSHandle<JSTaggedValue> result(thread, ret);
151 return result;
152 }
153
IteratorNext(JSThread * thread,const JSHandle<AsyncIteratorRecord> & iter,const JSHandle<JSTaggedValue> & value)154 JSHandle<JSTaggedValue> JSIterator::IteratorNext(JSThread *thread, const JSHandle<AsyncIteratorRecord> &iter,
155 const JSHandle<JSTaggedValue> &value)
156 {
157 const GlobalEnvConstants *globalConst = thread->GlobalConstants();
158 // 2.Let result be Invoke(iterator, "next", «value»).
159 JSHandle<JSTaggedValue> iterator(thread, iter->GetIterator());
160 JSHandle<JSTaggedValue> next(thread, iter->GetNextMethod());
161 JSHandle<JSTaggedValue> undefined = globalConst->GetHandledUndefined();
162 EcmaRuntimeCallInfo *info = EcmaInterpreter::NewRuntimeCallInfo(thread, next, iterator, undefined, 1);
163 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, undefined);
164 info->SetCallArg(value.GetTaggedValue());
165 JSTaggedValue ret = JSFunction::Call(info);
166 // 3.ReturnIfAbrupt(result)
167 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, undefined);
168 // 4.If Type(result) is not Object, throw a TypeError exception.
169 if (!ret.IsECMAObject()) {
170 THROW_TYPE_ERROR_AND_RETURN(thread, "Is not Object", undefined);
171 }
172 JSHandle<JSTaggedValue> result(thread, ret);
173 return result;
174 }
175
IteratorNext(JSThread * thread,const JSHandle<AsyncIteratorRecord> & iter)176 JSHandle<JSTaggedValue> JSIterator::IteratorNext(JSThread *thread, const JSHandle<AsyncIteratorRecord> &iter)
177 {
178 const GlobalEnvConstants *globalConst = thread->GlobalConstants();
179 // 2.Let result be Invoke(iterator, "next", «value»).
180 JSHandle<JSTaggedValue> iterator(thread, iter->GetIterator());
181 JSHandle<JSTaggedValue> next(thread, iter->GetNextMethod());
182 JSHandle<JSTaggedValue> undefined = globalConst->GetHandledUndefined();
183 EcmaRuntimeCallInfo *info = EcmaInterpreter::NewRuntimeCallInfo(thread, next, iterator, undefined, 0);
184 JSTaggedValue ret = JSFunction::Call(info);
185 // 3.ReturnIfAbrupt(result)
186 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, undefined);
187 // 4.If Type(result) is not Object, throw a TypeError exception.
188 if (!ret.IsECMAObject()) {
189 THROW_TYPE_ERROR_AND_RETURN(thread, "Is not Object", undefined);
190 }
191 JSHandle<JSTaggedValue> result(thread, ret);
192 return result;
193 }
194 // 7.4.3
IteratorComplete(JSThread * thread,const JSHandle<JSTaggedValue> & iterResult)195 bool JSIterator::IteratorComplete(JSThread *thread, const JSHandle<JSTaggedValue> &iterResult)
196 {
197 ASSERT_PRINT(iterResult->IsECMAObject(), "iterResult must be JSObject");
198 // Return ToBoolean(Get(iterResult, "done")).
199 JSHandle<JSTaggedValue> doneStr = thread->GlobalConstants()->GetHandledDoneString();
200 JSHandle<JSTaggedValue> done = JSTaggedValue::GetProperty(thread, iterResult, doneStr).GetValue();
201 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, false);
202 return done->ToBoolean();
203 }
204 // 7.4.4
IteratorValue(JSThread * thread,const JSHandle<JSTaggedValue> & iterResult)205 JSHandle<JSTaggedValue> JSIterator::IteratorValue(JSThread *thread, const JSHandle<JSTaggedValue> &iterResult)
206 {
207 ASSERT_PRINT(iterResult->IsECMAObject(), "iterResult must be JSObject");
208 // Return Get(iterResult, "value").
209 JSHandle<JSTaggedValue> valueStr = thread->GlobalConstants()->GetHandledValueString();
210 JSHandle<JSTaggedValue> value = JSTaggedValue::GetProperty(thread, iterResult, valueStr).GetValue();
211 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
212 return value;
213 }
214 // 7.4.5
IteratorStep(JSThread * thread,const JSHandle<JSTaggedValue> & iter)215 JSHandle<JSTaggedValue> JSIterator::IteratorStep(JSThread *thread, const JSHandle<JSTaggedValue> &iter)
216 {
217 // 1.Let result be IteratorNext(iterator).
218 JSHandle<JSTaggedValue> result = IteratorNext(thread, iter);
219 // 2.ReturnIfAbrupt(result).
220 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, result);
221 // 3.Let done be IteratorComplete(result).
222 bool done = IteratorComplete(thread, result);
223 // 4.ReturnIfAbrupt(done).
224 JSHandle<JSTaggedValue> doneHandle(thread, JSTaggedValue(done));
225 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, doneHandle);
226 // 5.If done is true, return false.
227 if (done) {
228 JSHandle<JSTaggedValue> falseHandle(thread, JSTaggedValue::False());
229 return falseHandle;
230 }
231 return result;
232 }
233 // 7.4.6
IteratorClose(JSThread * thread,const JSHandle<JSTaggedValue> & iter,const JSHandle<JSTaggedValue> & completion)234 JSHandle<JSTaggedValue> JSIterator::IteratorClose(JSThread *thread, const JSHandle<JSTaggedValue> &iter,
235 const JSHandle<JSTaggedValue> &completion)
236 {
237 // 1.Assert: Type(iterator) is Object.
238 ASSERT_PRINT(iter->IsECMAObject(), "iter must be JSObject");
239 const GlobalEnvConstants *globalConst = thread->GlobalConstants();
240 JSHandle<JSTaggedValue> exceptionOnThread;
241 if (thread->HasPendingException()) {
242 exceptionOnThread = JSHandle<JSTaggedValue>(thread, thread->GetException());
243 thread->ClearException();
244 }
245 JSTaggedValue returnStr = globalConst->GetReturnString();
246 // 3.Let return be GetMethod(iterator, "return").
247 JSTaggedValue func = ObjectFastOperator::FastGetPropertyByName(thread, iter.GetTaggedValue(), returnStr);
248 // 4.ReturnIfAbrupt(return).
249 JSHandle<JSTaggedValue> returnFunc(thread, func);
250 RETURN_VALUE_IF_ABRUPT_COMPLETION(thread, returnFunc);
251
252 // 5.If return is undefined, return Completion(completion).
253 if (returnFunc->IsUndefined() || returnFunc->IsNull()) {
254 if (!exceptionOnThread.IsEmpty()) {
255 thread->SetException(exceptionOnThread.GetTaggedValue());
256 }
257 return completion;
258 }
259
260 if (!returnFunc->IsCallable()) {
261 THROW_TYPE_ERROR_AND_RETURN(thread, "return function is not Callable", returnFunc);
262 }
263 // 6.Let innerResult be Call(return, iterator, « »).
264 JSHandle<JSTaggedValue> undefined = globalConst->GetHandledUndefined();
265 EcmaRuntimeCallInfo *info = EcmaInterpreter::NewRuntimeCallInfo(thread, returnFunc, iter, undefined, 0);
266 JSTaggedValue ret = JSFunction::Call(info);
267 RETURN_HANDLE_IF_ABRUPT_COMPLETION(JSTaggedValue, thread);
268 if (!exceptionOnThread.IsEmpty()) {
269 thread->SetException(exceptionOnThread.GetTaggedValue());
270 }
271 JSHandle<JSTaggedValue> innerResult(thread, ret);
272 JSHandle<CompletionRecord> completionRecord(thread, globalConst->GetUndefined());
273 if (completion->IsCompletionRecord()) {
274 completionRecord = JSHandle<CompletionRecord>::Cast(completion);
275 }
276 // 7.If completion.[[type]] is throw, return Completion(completion).
277 if (!completionRecord.GetTaggedValue().IsUndefined() && completionRecord->IsThrow()) {
278 if (!exceptionOnThread.IsEmpty()) {
279 thread->SetException(exceptionOnThread.GetTaggedValue());
280 }
281 return completion;
282 }
283 // 8.If innerResult.[[type]] is throw, return Completion(innerResult).
284 if (thread->HasPendingException()) {
285 return innerResult;
286 }
287 // 9.If Type(innerResult.[[value]]) is not Object, throw a TypeError exception.
288 if (!innerResult->IsECMAObject()) {
289 THROW_TYPE_ERROR_AND_RETURN(thread, "Is not object", undefined);
290 }
291 if (!exceptionOnThread.IsEmpty()) {
292 thread->SetException(exceptionOnThread.GetTaggedValue());
293 }
294 return completion;
295 }
296 // 7.4.7
CreateIterResultObject(JSThread * thread,const JSHandle<JSTaggedValue> & value,bool done)297 JSHandle<JSObject> JSIterator::CreateIterResultObject(JSThread *thread, const JSHandle<JSTaggedValue> &value, bool done)
298 {
299 ObjectFactory *factory = thread->GetEcmaVM()->GetFactory();
300 auto globalConst = thread->GlobalConstants();
301 // 2. Let obj be OrdinaryObjectCreate(%Object.prototype%).
302 JSHandle<JSHClass> klass = JSHandle<JSHClass>::Cast(globalConst->GetHandledIteratorResultClass());
303 JSHandle<JSObject> obj = factory->NewJSObject(klass);
304
305 // 3. Perform ! CreateDataPropertyOrThrow(obj, "value", value).
306 // 4. Perform ! CreateDataPropertyOrThrow(obj, "done", done).
307 obj->SetPropertyInlinedPropsWithSize<JSIterator::SIZE, VALUE_INLINE_PROPERTY_INDEX>(
308 thread, value.GetTaggedValue());
309 obj->SetPropertyInlinedPropsWithSize<JSIterator::SIZE, DONE_INLINE_PROPERTY_INDEX>(
310 thread, JSTaggedValue(done));
311 // 5. Return obj.
312 return obj;
313 }
314 } // namespace panda::ecmascript
315