JsrtCore.cpp 52 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563
  1. //-------------------------------------------------------------------------------------------------------
  2. // Copyright (C) Microsoft. All rights reserved.
  3. // Copyright (c) ChakraCore Project Contributors. All rights reserved.
  4. // Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
  5. //-------------------------------------------------------------------------------------------------------
  6. #include "JsrtPch.h"
  7. #include "JsrtInternal.h"
  8. #include "JsrtExternalObject.h"
  9. #include "JsrtExternalArrayBuffer.h"
  10. #include "jsrtHelper.h"
  11. #include "SCACorePch.h"
  12. #include "JsrtContextCore.h"
  13. #include "ChakraCore.h"
  14. #include "Common/ByteSwap.h"
  15. #include "Library/DataView.h"
  16. #include "Library/JavascriptExceptionMetadata.h"
  17. #include "Base/ThreadContextTlsEntry.h"
  18. #include "Library/JavascriptPromise.h"
  19. #include "Codex/Utf8Helper.h"
  20. CHAKRA_API
  21. JsInitializeModuleRecord(
  22. _In_opt_ JsModuleRecord referencingModule,
  23. _In_opt_ JsValueRef normalizedSpecifier,
  24. _Outptr_result_maybenull_ JsModuleRecord* moduleRecord)
  25. {
  26. PARAM_NOT_NULL(moduleRecord);
  27. Js::SourceTextModuleRecord* newModuleRecord = nullptr;
  28. JsErrorCode errorCode = ContextAPIWrapper_NoRecord<true>([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  29. newModuleRecord = Js::SourceTextModuleRecord::Create(scriptContext);
  30. newModuleRecord->SetSpecifier(normalizedSpecifier);
  31. return JsNoError;
  32. });
  33. if (errorCode == JsNoError)
  34. {
  35. *moduleRecord = newModuleRecord;
  36. }
  37. else
  38. {
  39. *moduleRecord = JS_INVALID_REFERENCE;
  40. }
  41. return errorCode;
  42. }
  43. CHAKRA_API
  44. JsParseModuleSource(
  45. _In_ JsModuleRecord requestModule,
  46. _In_ JsSourceContext sourceContext,
  47. _In_ byte* sourceText,
  48. _In_ unsigned int sourceLength,
  49. _In_ JsParseModuleSourceFlags sourceFlag,
  50. _Outptr_result_maybenull_ JsValueRef* exceptionValueRef)
  51. {
  52. PARAM_NOT_NULL(requestModule);
  53. PARAM_NOT_NULL(exceptionValueRef);
  54. if (sourceFlag > JsParseModuleSourceFlags_DataIsUTF8)
  55. {
  56. return JsErrorInvalidArgument;
  57. }
  58. *exceptionValueRef = JS_INVALID_REFERENCE;
  59. HRESULT hr;
  60. if (!Js::SourceTextModuleRecord::Is(requestModule))
  61. {
  62. return JsErrorInvalidArgument;
  63. }
  64. Js::SourceTextModuleRecord* moduleRecord = Js::SourceTextModuleRecord::FromHost(requestModule);
  65. if (moduleRecord->WasParsed())
  66. {
  67. return JsErrorModuleParsed;
  68. }
  69. Js::ScriptContext* scriptContext = moduleRecord->GetScriptContext();
  70. JsErrorCode errorCode = GlobalAPIWrapper_NoRecord([&]() -> JsErrorCode {
  71. SourceContextInfo* sourceContextInfo = scriptContext->GetSourceContextInfo(sourceContext, nullptr);
  72. if (sourceContextInfo == nullptr)
  73. {
  74. const char16 *moduleUrlSz = nullptr;
  75. size_t moduleUrlLen = 0;
  76. if (moduleRecord->GetSpecifier())
  77. {
  78. Js::JavascriptString *moduleUrl = Js::VarTo<Js::JavascriptString>(moduleRecord->GetSpecifier());
  79. moduleUrlSz = moduleUrl->GetSz();
  80. moduleUrlLen = moduleUrl->GetLength();
  81. }
  82. sourceContextInfo = scriptContext->CreateSourceContextInfo(sourceContext, moduleUrlSz, moduleUrlLen, nullptr, nullptr, 0);
  83. }
  84. SRCINFO si = {
  85. /* sourceContextInfo */ sourceContextInfo,
  86. /* dlnHost */ 0,
  87. /* ulColumnHost */ 0,
  88. /* lnMinHost */ 0,
  89. /* ichMinHost */ 0,
  90. /* ichLimHost */ static_cast<ULONG>(sourceLength),
  91. /* ulCharOffset */ 0,
  92. /* mod */ 0,
  93. /* grfsi */ 0
  94. };
  95. hr = moduleRecord->ParseSource(sourceText, sourceLength, &si, exceptionValueRef, sourceFlag == JsParseModuleSourceFlags_DataIsUTF8 ? true : false);
  96. if (FAILED(hr))
  97. {
  98. return JsErrorScriptCompile;
  99. }
  100. return JsNoError;
  101. });
  102. return errorCode;
  103. }
  104. CHAKRA_API
  105. JsModuleEvaluation(
  106. _In_ JsModuleRecord requestModule,
  107. _Outptr_result_maybenull_ JsValueRef* result)
  108. {
  109. if (!Js::SourceTextModuleRecord::Is(requestModule))
  110. {
  111. return JsErrorInvalidArgument;
  112. }
  113. Js::SourceTextModuleRecord* moduleRecord = Js::SourceTextModuleRecord::FromHost(requestModule);
  114. if (result != nullptr)
  115. {
  116. *result = JS_INVALID_REFERENCE;
  117. }
  118. Js::ScriptContext* scriptContext = moduleRecord->GetScriptContext();
  119. JsrtContext* jsrtContext = (JsrtContext*)scriptContext->GetLibrary()->GetJsrtContext();
  120. JsErrorCode errorCode = SetContextAPIWrapper(jsrtContext, [&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  121. SmartFPUControl smartFpuControl;
  122. if (smartFpuControl.HasErr())
  123. {
  124. return JsErrorBadFPUState;
  125. }
  126. JsValueRef returnRef = moduleRecord->ModuleEvaluation();
  127. if (result != nullptr)
  128. {
  129. *result = returnRef;
  130. }
  131. return JsNoError;
  132. });
  133. return errorCode;
  134. }
  135. CHAKRA_API
  136. JsSetModuleHostInfo(
  137. _In_opt_ JsModuleRecord requestModule,
  138. _In_ JsModuleHostInfoKind moduleHostInfo,
  139. _In_ void* hostInfo)
  140. {
  141. Js::ScriptContext* scriptContext;
  142. Js::SourceTextModuleRecord* moduleRecord;
  143. if (!Js::SourceTextModuleRecord::Is(requestModule))
  144. {
  145. if (moduleHostInfo == JsModuleHostInfo_Exception ||
  146. moduleHostInfo == JsModuleHostInfo_HostDefined ||
  147. moduleHostInfo == JsModuleHostInfo_Url)
  148. {
  149. return JsErrorInvalidArgument;
  150. }
  151. scriptContext = JsrtContext::GetCurrent()->GetScriptContext();
  152. }
  153. else
  154. {
  155. moduleRecord = Js::SourceTextModuleRecord::FromHost(requestModule);
  156. scriptContext = moduleRecord->GetScriptContext();
  157. }
  158. JsrtContext* jsrtContext = (JsrtContext*)scriptContext->GetLibrary()->GetJsrtContext();
  159. JsErrorCode errorCode = SetContextAPIWrapper(jsrtContext, [&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  160. JsrtContextCore* currentContext = static_cast<JsrtContextCore*>(JsrtContextCore::GetCurrent());
  161. switch (moduleHostInfo)
  162. {
  163. case JsModuleHostInfo_Exception:
  164. {
  165. HRESULT hr = moduleRecord->OnHostException(hostInfo);
  166. return (hr == NOERROR) ? JsNoError : JsErrorInvalidArgument;
  167. }
  168. case JsModuleHostInfo_HostDefined:
  169. moduleRecord->SetHostDefined(hostInfo);
  170. break;
  171. case JsModuleHostInfo_FetchImportedModuleCallback:
  172. currentContext->GetHostScriptContext()->SetFetchImportedModuleCallback(reinterpret_cast<FetchImportedModuleCallBack>(hostInfo));
  173. break;
  174. case JsModuleHostInfo_FetchImportedModuleFromScriptCallback:
  175. currentContext->GetHostScriptContext()->SetFetchImportedModuleFromScriptCallback(reinterpret_cast<FetchImportedModuleFromScriptCallBack>(hostInfo));
  176. break;
  177. case JsModuleHostInfo_NotifyModuleReadyCallback:
  178. currentContext->GetHostScriptContext()->SetNotifyModuleReadyCallback(reinterpret_cast<NotifyModuleReadyCallback>(hostInfo));
  179. break;
  180. case JsModuleHostInfo_InitializeImportMetaCallback:
  181. currentContext->GetHostScriptContext()->SetInitializeImportMetaCallback(reinterpret_cast<InitializeImportMetaCallback>(hostInfo));
  182. break;
  183. case JsModuleHostInfo_ReportModuleCompletionCallback:
  184. currentContext->GetHostScriptContext()->SetReportModuleCompletionCallback(reinterpret_cast<ReportModuleCompletionCallback>(hostInfo));
  185. break;
  186. case JsModuleHostInfo_Url:
  187. moduleRecord->SetSpecifier(hostInfo);
  188. break;
  189. default:
  190. return JsInvalidModuleHostInfoKind;
  191. };
  192. return JsNoError;
  193. });
  194. return errorCode;
  195. }
  196. CHAKRA_API
  197. JsGetModuleHostInfo(
  198. _In_ JsModuleRecord requestModule,
  199. _In_ JsModuleHostInfoKind moduleHostInfo,
  200. _Outptr_result_maybenull_ void** hostInfo)
  201. {
  202. if (!Js::SourceTextModuleRecord::Is(requestModule) || (hostInfo == nullptr))
  203. {
  204. return JsErrorInvalidArgument;
  205. }
  206. *hostInfo = nullptr;
  207. Js::SourceTextModuleRecord* moduleRecord = Js::SourceTextModuleRecord::FromHost(requestModule);
  208. Js::ScriptContext* scriptContext = moduleRecord->GetScriptContext();
  209. JsrtContext* jsrtContext = (JsrtContext*)scriptContext->GetLibrary()->GetJsrtContext();
  210. JsErrorCode errorCode = SetContextAPIWrapper(jsrtContext, [&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  211. JsrtContextCore* currentContext = static_cast<JsrtContextCore*>(JsrtContextCore::GetCurrent());
  212. switch (moduleHostInfo)
  213. {
  214. case JsModuleHostInfo_Exception:
  215. if (moduleRecord->GetErrorObject() != nullptr)
  216. {
  217. *hostInfo = moduleRecord->GetErrorObject();
  218. }
  219. break;
  220. case JsModuleHostInfo_HostDefined:
  221. *hostInfo = moduleRecord->GetHostDefined();
  222. break;
  223. case JsModuleHostInfo_FetchImportedModuleCallback:
  224. *hostInfo = reinterpret_cast<void*>(currentContext->GetHostScriptContext()->GetFetchImportedModuleCallback());
  225. break;
  226. case JsModuleHostInfo_FetchImportedModuleFromScriptCallback:
  227. *hostInfo = reinterpret_cast<void*>(currentContext->GetHostScriptContext()->GetFetchImportedModuleFromScriptCallback());
  228. break;
  229. case JsModuleHostInfo_NotifyModuleReadyCallback:
  230. *hostInfo = reinterpret_cast<void*>(currentContext->GetHostScriptContext()->GetNotifyModuleReadyCallback());
  231. break;
  232. case JsModuleHostInfo_InitializeImportMetaCallback:
  233. *hostInfo = reinterpret_cast<void*>(currentContext->GetHostScriptContext()->GetInitializeImportMetaCallback());
  234. break;
  235. case JsModuleHostInfo_ReportModuleCompletionCallback:
  236. *hostInfo = reinterpret_cast<void*>(currentContext->GetHostScriptContext()->GetReportModuleCompletionCallback());
  237. break;
  238. case JsModuleHostInfo_Url:
  239. *hostInfo = reinterpret_cast<void*>(moduleRecord->GetSpecifier());
  240. break;
  241. default:
  242. return JsInvalidModuleHostInfoKind;
  243. };
  244. return JsNoError;
  245. });
  246. return errorCode;
  247. }
  248. CHAKRA_API JsGetModuleNamespace(_In_ JsModuleRecord requestModule, _Outptr_result_maybenull_ JsValueRef *moduleNamespace)
  249. {
  250. PARAM_NOT_NULL(moduleNamespace);
  251. *moduleNamespace = nullptr;
  252. if (!Js::SourceTextModuleRecord::Is(requestModule))
  253. {
  254. return JsErrorInvalidArgument;
  255. }
  256. Js::SourceTextModuleRecord* moduleRecord = Js::SourceTextModuleRecord::FromHost(requestModule);
  257. if (!moduleRecord->WasEvaluated())
  258. {
  259. return JsErrorModuleNotEvaluated;
  260. }
  261. if (moduleRecord->GetErrorObject() != nullptr)
  262. {
  263. return JsErrorInvalidArgument;
  264. }
  265. *moduleNamespace = static_cast<JsValueRef>(moduleRecord->GetNamespace());
  266. return JsNoError;
  267. }
  268. CHAKRA_API
  269. JsVarSerializer(
  270. _In_ ReallocateBufferMemoryFunc reallocateBufferMemory,
  271. _In_ WriteHostObjectFunc writeHostObject,
  272. _In_opt_ void * callbackState,
  273. _Out_ JsVarSerializerHandle *serializerHandle)
  274. {
  275. PARAM_NOT_NULL(reallocateBufferMemory);
  276. PARAM_NOT_NULL(writeHostObject);
  277. PARAM_NOT_NULL(serializerHandle);
  278. JsErrorCode errorCode = ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  279. ChakraCoreStreamWriter *writer = HeapNew(ChakraCoreStreamWriter, reallocateBufferMemory, writeHostObject, callbackState);
  280. writer->SetSerializer(HeapNew(Js::SCACore::Serializer, scriptContext, writer));
  281. *serializerHandle = writer;
  282. return JsNoError;
  283. });
  284. return errorCode;
  285. }
  286. CHAKRA_API
  287. JsVarSerializerWriteRawBytes(
  288. _In_ JsVarSerializerHandle serializerHandle,
  289. _In_ const void* source,
  290. _In_ size_t length)
  291. {
  292. PARAM_NOT_NULL(serializerHandle);
  293. PARAM_NOT_NULL(source);
  294. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  295. ChakraCoreStreamWriter* streamWriter = reinterpret_cast<ChakraCoreStreamWriter*>(serializerHandle);
  296. streamWriter->WriteRawBytes(source, length);
  297. return JsNoError;
  298. });
  299. }
  300. CHAKRA_API
  301. JsVarSerializerWriteValue(
  302. _In_ JsVarSerializerHandle serializerHandle,
  303. _In_ JsValueRef rootObject)
  304. {
  305. PARAM_NOT_NULL(serializerHandle);
  306. PARAM_NOT_NULL(rootObject);
  307. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  308. ChakraCoreStreamWriter* streamWriter = reinterpret_cast<ChakraCoreStreamWriter*>(serializerHandle);
  309. streamWriter->WriteValue(rootObject);
  310. return JsNoError;
  311. });
  312. }
  313. CHAKRA_API
  314. JsVarSerializerReleaseData(
  315. _In_ JsVarSerializerHandle serializerHandle,
  316. _Out_ byte** data,
  317. _Out_ size_t *dataLength)
  318. {
  319. PARAM_NOT_NULL(serializerHandle);
  320. PARAM_NOT_NULL(data);
  321. PARAM_NOT_NULL(dataLength);
  322. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  323. ChakraCoreStreamWriter* streamWriter = reinterpret_cast<ChakraCoreStreamWriter*>(serializerHandle);
  324. if (!streamWriter->ReleaseData(data, dataLength))
  325. {
  326. return JsErrorInvalidArgument;
  327. }
  328. return JsNoError;
  329. });
  330. }
  331. CHAKRA_API
  332. JsVarSerializerDetachArrayBuffer(_In_ JsVarSerializerHandle serializerHandle)
  333. {
  334. PARAM_NOT_NULL(serializerHandle);
  335. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  336. ChakraCoreStreamWriter* streamWriter = reinterpret_cast<ChakraCoreStreamWriter*>(serializerHandle);
  337. if (!streamWriter->DetachArrayBuffer())
  338. {
  339. return JsErrorInvalidArgument;
  340. }
  341. return JsNoError;
  342. });
  343. }
  344. CHAKRA_API
  345. JsVarSerializerSetTransferableVars(
  346. _In_ JsVarSerializerHandle serializerHandle,
  347. _In_opt_ JsValueRef *transferableVars,
  348. _In_ size_t transferableVarsCount)
  349. {
  350. PARAM_NOT_NULL(serializerHandle);
  351. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  352. ChakraCoreStreamWriter* streamWriter = reinterpret_cast<ChakraCoreStreamWriter*>(serializerHandle);
  353. return streamWriter->SetTransferableVars(transferableVars, transferableVarsCount);
  354. });
  355. }
  356. CHAKRA_API
  357. JsVarSerializerFree(_In_ JsVarSerializerHandle serializerHandle)
  358. {
  359. PARAM_NOT_NULL(serializerHandle);
  360. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  361. ChakraCoreStreamWriter* streamWriter = reinterpret_cast<ChakraCoreStreamWriter*>(serializerHandle);
  362. streamWriter->FreeSelf();
  363. return JsNoError;
  364. });
  365. }
  366. CHAKRA_API
  367. JsVarDeserializer(
  368. _In_ void *data,
  369. _In_ size_t size,
  370. _In_ ReadHostObjectFunc readHostObject,
  371. _In_ GetSharedArrayBufferFromIdFunc getSharedArrayBufferFromId,
  372. _In_opt_ void* callbackState,
  373. _Out_ JsVarDeserializerHandle *deserializerHandle)
  374. {
  375. PARAM_NOT_NULL(data);
  376. PARAM_NOT_NULL(readHostObject);
  377. PARAM_NOT_NULL(getSharedArrayBufferFromId);
  378. PARAM_NOT_NULL(deserializerHandle);
  379. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  380. ChakraHostDeserializerHandle *reader = HeapNew(ChakraHostDeserializerHandle, readHostObject, getSharedArrayBufferFromId, callbackState);
  381. reader->SetDeserializer(HeapNew(Js::SCACore::Deserializer, data, size, scriptContext, reader));
  382. *deserializerHandle = reader;
  383. return JsNoError;
  384. });
  385. }
  386. CHAKRA_API
  387. JsVarDeserializerReadRawBytes(_In_ JsVarDeserializerHandle deserializerHandle, _In_ size_t length, _Out_ void **data)
  388. {
  389. PARAM_NOT_NULL(deserializerHandle);
  390. PARAM_NOT_NULL(data);
  391. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  392. ChakraHostDeserializerHandle* deserializer = reinterpret_cast<ChakraHostDeserializerHandle*>(deserializerHandle);
  393. if (!deserializer->ReadRawBytes(length, data))
  394. {
  395. return JsErrorInvalidArgument;
  396. }
  397. return JsNoError;
  398. });
  399. }
  400. CHAKRA_API
  401. JsVarDeserializerReadBytes(_In_ JsVarDeserializerHandle deserializerHandle, _In_ size_t length, _Out_ void **data)
  402. {
  403. PARAM_NOT_NULL(deserializerHandle);
  404. PARAM_NOT_NULL(data);
  405. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  406. ChakraHostDeserializerHandle* deserializer = reinterpret_cast<ChakraHostDeserializerHandle*>(deserializerHandle);
  407. if (!deserializer->ReadBytes(length, data))
  408. {
  409. return JsErrorInvalidArgument;
  410. }
  411. return JsNoError;
  412. });
  413. }
  414. CHAKRA_API
  415. JsVarDeserializerReadValue(_In_ JsVarDeserializerHandle deserializerHandle, _Out_ JsValueRef* value)
  416. {
  417. PARAM_NOT_NULL(deserializerHandle);
  418. PARAM_NOT_NULL(value);
  419. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  420. ChakraHostDeserializerHandle* deserializer = reinterpret_cast<ChakraHostDeserializerHandle*>(deserializerHandle);
  421. *value = deserializer->ReadValue();
  422. return JsNoError;
  423. });
  424. }
  425. CHAKRA_API
  426. JsVarDeserializerSetTransferableVars(_In_ JsVarDeserializerHandle deserializerHandle, _In_opt_ JsValueRef *transferableVars, _In_ size_t transferableVarsCount)
  427. {
  428. PARAM_NOT_NULL(deserializerHandle);
  429. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  430. ChakraHostDeserializerHandle* deserializer = reinterpret_cast<ChakraHostDeserializerHandle*>(deserializerHandle);
  431. return deserializer->SetTransferableVars(transferableVars, transferableVarsCount);
  432. });
  433. }
  434. CHAKRA_API
  435. JsVarDeserializerFree(_In_ JsVarDeserializerHandle deserializerHandle)
  436. {
  437. PARAM_NOT_NULL(deserializerHandle);
  438. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  439. ChakraHostDeserializerHandle* deserializer = reinterpret_cast<ChakraHostDeserializerHandle*>(deserializerHandle);
  440. deserializer->FreeSelf();
  441. return JsNoError;
  442. });
  443. }
  444. CHAKRA_API
  445. JsGetArrayBufferExtraInfo(
  446. _In_ JsValueRef arrayBuffer,
  447. _Out_ char *extraInfo)
  448. {
  449. VALIDATE_JSREF(arrayBuffer);
  450. PARAM_NOT_NULL(extraInfo);
  451. BEGIN_JSRT_NO_EXCEPTION
  452. {
  453. if (!Js::VarIs<Js::ArrayBuffer>(arrayBuffer))
  454. {
  455. RETURN_NO_EXCEPTION(JsErrorInvalidArgument);
  456. }
  457. *extraInfo = Js::VarTo<Js::ArrayBuffer>(arrayBuffer)->GetExtraInfoBits();
  458. }
  459. END_JSRT_NO_EXCEPTION
  460. }
  461. CHAKRA_API
  462. JsSetArrayBufferExtraInfo(
  463. _In_ JsValueRef arrayBuffer,
  464. _In_ char extraInfo)
  465. {
  466. VALIDATE_JSREF(arrayBuffer);
  467. BEGIN_JSRT_NO_EXCEPTION
  468. {
  469. if (!Js::VarIs<Js::ArrayBuffer>(arrayBuffer))
  470. {
  471. RETURN_NO_EXCEPTION(JsErrorInvalidArgument);
  472. }
  473. Js::VarTo<Js::ArrayBuffer>(arrayBuffer)->SetExtraInfoBits(extraInfo);
  474. }
  475. END_JSRT_NO_EXCEPTION
  476. }
  477. CHAKRA_API
  478. JsGetEmbedderData(
  479. _In_ JsValueRef instance,
  480. _Out_ JsValueRef* embedderData)
  481. {
  482. VALIDATE_JSREF(instance);
  483. PARAM_NOT_NULL(embedderData);
  484. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext* scriptContext) -> JsErrorCode {
  485. Js::RecyclableObject* object = Js::JavascriptOperators::TryFromVar<Js::RecyclableObject>(instance);
  486. if (!object)
  487. {
  488. return JsErrorInvalidArgument;
  489. }
  490. // Right now we know that we support these many. Lets find out if
  491. // there are more.
  492. Assert(Js::TypedArrayBase::Is(object->GetTypeId()) ||
  493. object->GetTypeId() == Js::TypeIds_ArrayBuffer ||
  494. object->GetTypeId() == Js::TypeIds_DataView ||
  495. object->GetTypeId() == Js::TypeIds_SharedArrayBuffer);
  496. if (!object->GetInternalProperty(object, Js::InternalPropertyIds::EmbedderData, embedderData, nullptr, scriptContext))
  497. {
  498. *embedderData = nullptr;
  499. }
  500. return JsNoError;
  501. });
  502. }
  503. CHAKRA_API
  504. JsSetEmbedderData(_In_ JsValueRef instance, _In_ JsValueRef embedderData)
  505. {
  506. VALIDATE_JSREF(instance);
  507. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext* scriptContext) -> JsErrorCode {
  508. Js::RecyclableObject* object = Js::JavascriptOperators::TryFromVar<Js::RecyclableObject>(instance);
  509. if (!object)
  510. {
  511. return JsErrorInvalidArgument;
  512. }
  513. // Right now we know that we support these many. Lets find out if
  514. // there are more.
  515. Assert(Js::TypedArrayBase::Is(object->GetTypeId()) ||
  516. object->GetTypeId() == Js::TypeIds_ArrayBuffer ||
  517. object->GetTypeId() == Js::TypeIds_DataView ||
  518. object->GetTypeId() == Js::TypeIds_SharedArrayBuffer);
  519. if (!object->SetInternalProperty(Js::InternalPropertyIds::EmbedderData, embedderData, Js::PropertyOperationFlags::PropertyOperation_None, nullptr))
  520. {
  521. return JsErrorInvalidArgument;
  522. }
  523. return JsNoError;
  524. });
  525. }
  526. CHAKRA_API
  527. JsExternalizeArrayBuffer(
  528. _In_ JsValueRef arrayBufferVar)
  529. {
  530. VALIDATE_JSREF(arrayBufferVar);
  531. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  532. Js::ArrayBuffer* arrayBuffer = Js::JavascriptOperators::TryFromVar<Js::ArrayBuffer>(arrayBufferVar);
  533. if (!arrayBuffer)
  534. {
  535. return JsErrorInvalidArgument;
  536. }
  537. arrayBuffer->Externalize();
  538. return JsNoError;
  539. });
  540. }
  541. CHAKRA_API
  542. JsHasOwnItem(_In_ JsValueRef object,
  543. _In_ uint32_t index,
  544. _Out_ bool* hasOwnItem)
  545. {
  546. return ContextAPIWrapper<true>(
  547. [&](Js::ScriptContext* scriptContext,
  548. TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  549. VALIDATE_INCOMING_OBJECT(object, scriptContext);
  550. PARAM_NOT_NULL(hasOwnItem);
  551. *hasOwnItem = !!Js::JavascriptOperators::HasOwnItem(
  552. Js::VarTo<Js::RecyclableObject>(object), index);
  553. return JsNoError;
  554. });
  555. }
  556. CHAKRA_API
  557. JsDetachArrayBuffer(
  558. _In_ JsValueRef arrayBuffer)
  559. {
  560. VALIDATE_JSREF(arrayBuffer);
  561. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  562. if (!Js::VarIs<Js::ArrayBuffer>(arrayBuffer))
  563. {
  564. return JsErrorInvalidArgument;
  565. }
  566. Js::VarTo<Js::ArrayBuffer>(arrayBuffer)->Detach();
  567. return JsNoError;
  568. });
  569. }
  570. CHAKRA_API JsCreateSharedArrayBufferWithSharedContent(_In_ JsSharedArrayBufferContentHandle sharedContents, _Out_ JsValueRef *result)
  571. {
  572. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  573. PARAM_NOT_NULL(result);
  574. Js::JavascriptLibrary* library = scriptContext->GetLibrary();
  575. *result = library->CreateSharedArrayBuffer((Js::SharedContents*)sharedContents);
  576. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, result);
  577. JS_ETW(EventWriteJSCRIPT_RECYCLER_ALLOCATE_OBJECT(*result));
  578. return JsNoError;
  579. });
  580. }
  581. CHAKRA_API JsGetSharedArrayBufferContent(_In_ JsValueRef sharedArrayBuffer, _Out_ JsSharedArrayBufferContentHandle *sharedContents)
  582. {
  583. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  584. PARAM_NOT_NULL(sharedContents);
  585. if (!Js::VarIs<Js::SharedArrayBuffer>(sharedArrayBuffer))
  586. {
  587. return JsErrorInvalidArgument;
  588. }
  589. Js::SharedContents**& content = (Js::SharedContents**&)sharedContents;
  590. *content = Js::VarTo<Js::SharedArrayBuffer>(sharedArrayBuffer)->GetSharedContents();
  591. if (*content == nullptr)
  592. {
  593. return JsErrorFatal;
  594. }
  595. (*content)->AddRef();
  596. return JsNoError;
  597. });
  598. }
  599. CHAKRA_API JsReleaseSharedArrayBufferContentHandle(_In_ JsSharedArrayBufferContentHandle sharedContents)
  600. {
  601. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  602. ((Js::SharedContents*)sharedContents)->Release();
  603. return JsNoError;
  604. });
  605. }
  606. CHAKRA_API JsCreateCustomExternalObject(
  607. _In_opt_ void *data,
  608. _In_opt_ size_t inlineSlotSize,
  609. _In_opt_ JsTraceCallback traceCallback,
  610. _In_opt_ JsFinalizeCallback finalizeCallback,
  611. _Inout_opt_ JsGetterSetterInterceptor ** getterSetterInterceptor,
  612. _In_opt_ JsValueRef prototype,
  613. _Out_ JsValueRef * object)
  614. {
  615. return ContextAPINoScriptWrapper([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  616. PERFORM_JSRT_TTD_RECORD_ACTION(scriptContext, RecordJsRTAllocateExternalObject, prototype);
  617. PARAM_NOT_NULL(object);
  618. Js::RecyclableObject * prototypeObject = nullptr;
  619. if (prototype != JS_INVALID_REFERENCE)
  620. {
  621. VALIDATE_INCOMING_OBJECT_OR_NULL(prototype, scriptContext);
  622. prototypeObject = Js::VarTo<Js::RecyclableObject>(prototype);
  623. }
  624. if (inlineSlotSize > UINT32_MAX)
  625. {
  626. return JsErrorInvalidArgument;
  627. }
  628. Js::JsGetterSetterInterceptor * interceptor = nullptr;
  629. *object = Js::CustomExternalWrapperObject::Create(data, (uint)inlineSlotSize, traceCallback, finalizeCallback, &interceptor, prototypeObject, scriptContext);
  630. Assert(interceptor);
  631. *getterSetterInterceptor = reinterpret_cast<JsGetterSetterInterceptor*>(interceptor);
  632. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, object);
  633. return JsNoError;
  634. });
  635. }
  636. CHAKRA_API JsCreateTracedExternalObject(
  637. _In_opt_ void *data,
  638. _In_opt_ size_t inlineSlotSize,
  639. _In_opt_ JsTraceCallback traceCallback,
  640. _In_opt_ JsFinalizeCallback finalizeCallback,
  641. _In_opt_ JsValueRef prototype,
  642. _Out_ JsValueRef *object)
  643. {
  644. return ContextAPINoScriptWrapper([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  645. PERFORM_JSRT_TTD_RECORD_ACTION(scriptContext, RecordJsRTAllocateExternalObject, prototype);
  646. PARAM_NOT_NULL(object);
  647. Js::RecyclableObject * prototypeObject = nullptr;
  648. if (prototype != JS_INVALID_REFERENCE)
  649. {
  650. VALIDATE_INCOMING_OBJECT_OR_NULL(prototype, scriptContext);
  651. prototypeObject = Js::VarTo<Js::RecyclableObject>(prototype);
  652. }
  653. if (inlineSlotSize > UINT32_MAX)
  654. {
  655. return JsErrorInvalidArgument;
  656. }
  657. *object = JsrtExternalObject::Create(data, (uint)inlineSlotSize, traceCallback, finalizeCallback, prototypeObject, scriptContext, nullptr);
  658. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, object);
  659. return JsNoError;
  660. });
  661. }
  662. CHAKRA_API JsPrivateHasProperty(
  663. _In_ JsValueRef object,
  664. _In_ JsValueRef key,
  665. _Out_ bool *hasProperty)
  666. {
  667. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  668. PERFORM_JSRT_TTD_RECORD_ACTION_NOT_IMPLEMENTED(scriptContext);
  669. VALIDATE_INCOMING_OBJECT(object, scriptContext);
  670. VALIDATE_INCOMING_REFERENCE(key, scriptContext);
  671. PARAM_NOT_NULL(hasProperty);
  672. *hasProperty = false;
  673. Js::DynamicObject* dynObj = Js::VarTo<Js::DynamicObject>(object);
  674. if (!dynObj->HasObjectArray())
  675. {
  676. return JsNoError;
  677. }
  678. *hasProperty = Js::JavascriptOperators::OP_HasItem(dynObj->GetObjectArray(), key, scriptContext) != 0;
  679. return JsNoError;
  680. });
  681. }
  682. CHAKRA_API JsPrivateGetProperty(
  683. _In_ JsValueRef object,
  684. _In_ JsValueRef key,
  685. _Out_ JsValueRef *value)
  686. {
  687. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  688. PERFORM_JSRT_TTD_RECORD_ACTION(scriptContext, RecordJsRTGetIndex, key, object);
  689. VALIDATE_INCOMING_OBJECT(object, scriptContext);
  690. VALIDATE_INCOMING_REFERENCE(key, scriptContext);
  691. PARAM_NOT_NULL(value);
  692. *value = nullptr;
  693. Js::DynamicObject* dynObj = Js::VarTo<Js::DynamicObject>(object);
  694. if (!dynObj->HasObjectArray())
  695. {
  696. *value = scriptContext->GetLibrary()->GetUndefined();
  697. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, value);
  698. return JsNoError;
  699. }
  700. *value = (JsValueRef)Js::JavascriptOperators::OP_GetElementI(dynObj->GetObjectArray(), key, scriptContext);
  701. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, value);
  702. return JsNoError;
  703. });
  704. }
  705. CHAKRA_API JsPrivateSetProperty(
  706. _In_ JsValueRef object,
  707. _In_ JsValueRef key,
  708. _In_ JsValueRef value)
  709. {
  710. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  711. PERFORM_JSRT_TTD_RECORD_ACTION(scriptContext, RecordJsRTSetIndex, object, key, value);
  712. VALIDATE_INCOMING_OBJECT(object, scriptContext);
  713. VALIDATE_INCOMING_REFERENCE(key, scriptContext);
  714. VALIDATE_INCOMING_REFERENCE(value, scriptContext);
  715. Js::DynamicObject* dynObj = Js::VarTo<Js::DynamicObject>(object);
  716. if (!dynObj->HasObjectArray())
  717. {
  718. Js::ArrayObject* objArray = scriptContext->GetLibrary()->CreateArray();
  719. dynObj->SetObjectArray(objArray);
  720. }
  721. Js::JavascriptOperators::OP_SetElementI(dynObj->GetObjectArray(), key, value, scriptContext);
  722. return JsNoError;
  723. });
  724. }
  725. CHAKRA_API JsPrivateDeleteProperty(
  726. _In_ JsValueRef object,
  727. _In_ JsValueRef key,
  728. _Out_ JsValueRef *result)
  729. {
  730. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  731. PERFORM_JSRT_TTD_RECORD_ACTION_NOT_IMPLEMENTED(scriptContext);
  732. VALIDATE_INCOMING_OBJECT(object, scriptContext);
  733. VALIDATE_INCOMING_REFERENCE(key, scriptContext);
  734. Js::DynamicObject* dynObj = Js::VarTo<Js::DynamicObject>(object);
  735. if (!dynObj->HasObjectArray())
  736. {
  737. *result = scriptContext->GetLibrary()->GetFalse();
  738. return JsNoError;
  739. }
  740. *result = Js::JavascriptOperators::OP_DeleteElementI(dynObj->GetObjectArray(), key, scriptContext);
  741. return JsNoError;
  742. });
  743. }
  744. CHAKRA_API JsCloneObject(_In_ JsValueRef source, _Out_ JsValueRef* newObject)
  745. {
  746. VALIDATE_JSREF(source);
  747. return ContextAPINoScriptWrapper([&](Js::ScriptContext* scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  748. while (Js::VarIs<Js::JavascriptProxy>(source))
  749. {
  750. source = Js::UnsafeVarTo<Js::JavascriptProxy>(source)->GetTarget();
  751. }
  752. // We can currently only clone certain types of dynamic objects
  753. // TODO: support other object types
  754. if (Js::DynamicObject::IsBaseDynamicObject(source) ||
  755. Js::VarIs<JsrtExternalObject>(source) ||
  756. Js::VarIs<Js::CustomExternalWrapperObject>(source))
  757. {
  758. Js::DynamicObject* objSource = Js::UnsafeVarTo<Js::DynamicObject>(source);
  759. *newObject = objSource->Copy(true);
  760. return JsNoError;
  761. }
  762. return JsErrorInvalidArgument;
  763. });
  764. }
  765. template <class SrcChar, class DstChar>
  766. static void CastCopy(const SrcChar* src, DstChar* dst, size_t count)
  767. {
  768. const SrcChar* end = src + count;
  769. while (src < end)
  770. {
  771. *dst++ = static_cast<DstChar>(*src++);
  772. }
  773. }
  774. CHAKRA_API JsCreateString(
  775. _In_ const char *content,
  776. _In_ size_t length,
  777. _Out_ JsValueRef *value)
  778. {
  779. PARAM_NOT_NULL(content);
  780. PARAM_NOT_NULL(value);
  781. *value = JS_INVALID_REFERENCE;
  782. if (length == static_cast<size_t>(-1))
  783. {
  784. length = strlen(content);
  785. }
  786. if (length > MaxCharCount)
  787. {
  788. return JsErrorOutOfMemory;
  789. }
  790. return ContextAPINoScriptWrapper([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  791. Js::JavascriptString *stringValue = Js::LiteralStringWithPropertyStringPtr::
  792. NewFromCString(content, (CharCount)length, scriptContext->GetLibrary());
  793. PERFORM_JSRT_TTD_RECORD_ACTION(scriptContext, RecordJsRTCreateString, stringValue->GetSz(), stringValue->GetLength());
  794. *value = stringValue;
  795. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, value);
  796. return JsNoError;
  797. });
  798. }
  799. CHAKRA_API JsCreateStringUtf16(
  800. _In_ const uint16_t *content,
  801. _In_ size_t length,
  802. _Out_ JsValueRef *value)
  803. {
  804. PARAM_NOT_NULL(content);
  805. PARAM_NOT_NULL(value);
  806. *value = JS_INVALID_REFERENCE;
  807. if (length == static_cast<size_t>(-1))
  808. {
  809. length = wcslen((const char16 *)content);
  810. }
  811. if (length > static_cast<CharCount>(-1))
  812. {
  813. return JsErrorOutOfMemory;
  814. }
  815. return ContextAPINoScriptWrapper([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  816. Js::JavascriptString *stringValue = Js::LiteralStringWithPropertyStringPtr::
  817. NewFromWideString((const char16 *)content, (CharCount)length, scriptContext->GetLibrary());
  818. PERFORM_JSRT_TTD_RECORD_ACTION(scriptContext, RecordJsRTCreateString, stringValue->GetSz(), stringValue->GetLength());
  819. *value = stringValue;
  820. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, value);
  821. return JsNoError;
  822. });
  823. }
  824. CHAKRA_API JsCreatePropertyString(
  825. _In_z_ const char *name,
  826. _In_ size_t length,
  827. _Out_ JsValueRef *propertyString)
  828. {
  829. return ContextAPINoScriptWrapper([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  830. PERFORM_JSRT_TTD_RECORD_ACTION_NOT_IMPLEMENTED(scriptContext);
  831. Js::PropertyRecord* propertyRecord;
  832. JsErrorCode errorCode = JsCreatePropertyId(name, length, (JsPropertyIdRef *)&propertyRecord);
  833. if (errorCode != JsNoError)
  834. {
  835. return errorCode;
  836. }
  837. *propertyString = scriptContext->GetPropertyString(propertyRecord);
  838. return JsNoError;
  839. });
  840. }
  841. CHAKRA_API JsCreatePromise(_Out_ JsValueRef *promise, _Out_ JsValueRef *resolve, _Out_ JsValueRef *reject)
  842. {
  843. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  844. PERFORM_JSRT_TTD_RECORD_ACTION_NOT_IMPLEMENTED(scriptContext);
  845. PARAM_NOT_NULL(promise);
  846. PARAM_NOT_NULL(resolve);
  847. PARAM_NOT_NULL(reject);
  848. *promise = nullptr;
  849. *resolve = nullptr;
  850. *reject = nullptr;
  851. Js::JavascriptPromiseResolveOrRejectFunction *jsResolve = nullptr;
  852. Js::JavascriptPromiseResolveOrRejectFunction *jsReject = nullptr;
  853. Js::JavascriptPromise *jsPromise = scriptContext->GetLibrary()->CreatePromise();
  854. Js::JavascriptPromise::InitializePromise(jsPromise, &jsResolve, &jsReject, scriptContext);
  855. *promise = (JsValueRef)jsPromise;
  856. *resolve = (JsValueRef)jsResolve;
  857. *reject = (JsValueRef)jsReject;
  858. return JsNoError;
  859. });
  860. }
  861. CHAKRA_API JsGetPromiseState(_In_ JsValueRef promise, _Out_ JsPromiseState *state)
  862. {
  863. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  864. PERFORM_JSRT_TTD_RECORD_ACTION_NOT_IMPLEMENTED(scriptContext);
  865. VALIDATE_INCOMING_REFERENCE(promise, scriptContext);
  866. PARAM_NOT_NULL(state);
  867. *state = JsPromiseStatePending;
  868. if (!Js::VarIs<Js::JavascriptPromise>(promise))
  869. {
  870. return JsErrorInvalidArgument;
  871. }
  872. Js::JavascriptPromise *jsPromise = Js::VarTo<Js::JavascriptPromise>(promise);
  873. Js::JavascriptPromise::PromiseStatus status = jsPromise->GetStatus();
  874. switch (status)
  875. {
  876. case Js::JavascriptPromise::PromiseStatus::PromiseStatusCode_HasRejection:
  877. *state = JsPromiseStateRejected;
  878. break;
  879. case Js::JavascriptPromise::PromiseStatus::PromiseStatusCode_HasResolution:
  880. *state = JsPromiseStateFulfilled;
  881. break;
  882. }
  883. return JsNoError;
  884. });
  885. }
  886. CHAKRA_API JsGetPromiseResult(_In_ JsValueRef promise, _Out_ JsValueRef *result)
  887. {
  888. return ContextAPIWrapper<JSRT_MAYBE_TRUE>([&](Js::ScriptContext *scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  889. PERFORM_JSRT_TTD_RECORD_ACTION_NOT_IMPLEMENTED(scriptContext);
  890. VALIDATE_INCOMING_REFERENCE(promise, scriptContext);
  891. PARAM_NOT_NULL(result);
  892. *result = JS_INVALID_REFERENCE;
  893. if (!Js::VarIs<Js::JavascriptPromise>(promise))
  894. {
  895. return JsErrorInvalidArgument;
  896. }
  897. Js::JavascriptPromise *jsPromise = Js::VarTo<Js::JavascriptPromise>(promise);
  898. Js::Var jsResult = jsPromise->GetResult();
  899. if (jsResult == nullptr)
  900. {
  901. return JsErrorPromisePending;
  902. }
  903. *result = (JsValueRef)jsResult;
  904. return JsNoError;
  905. });
  906. }
  907. CHAKRA_API JsCreateWeakReference(
  908. _In_ JsValueRef value,
  909. _Out_ JsWeakRef* weakRef)
  910. {
  911. VALIDATE_JSREF(value);
  912. PARAM_NOT_NULL(weakRef);
  913. *weakRef = nullptr;
  914. if (Js::TaggedNumber::Is(value))
  915. {
  916. return JsNoWeakRefRequired;
  917. }
  918. return GlobalAPIWrapper_NoRecord([&]() -> JsErrorCode {
  919. ThreadContext* threadContext = ThreadContext::GetContextForCurrentThread();
  920. if (threadContext == nullptr)
  921. {
  922. return JsErrorNoCurrentContext;
  923. }
  924. Recycler* recycler = threadContext->GetRecycler();
  925. if (recycler->IsInObjectBeforeCollectCallback())
  926. {
  927. return JsErrorInObjectBeforeCollectCallback;
  928. }
  929. RecyclerHeapObjectInfo dummyObjectInfo;
  930. if (!recycler->FindHeapObject(value, Memory::FindHeapObjectFlags::FindHeapObjectFlags_NoFlags, dummyObjectInfo))
  931. {
  932. // value is not recyler-allocated
  933. return JsErrorInvalidArgument;
  934. }
  935. recycler->FindOrCreateWeakReferenceHandle<char>(
  936. reinterpret_cast<char*>(value),
  937. reinterpret_cast<Memory::RecyclerWeakReference<char>**>(weakRef));
  938. return JsNoError;
  939. });
  940. }
  941. CHAKRA_API JsGetWeakReferenceValue(
  942. _In_ JsWeakRef weakRef,
  943. _Out_ JsValueRef* value)
  944. {
  945. VALIDATE_JSREF(weakRef);
  946. PARAM_NOT_NULL(value);
  947. *value = JS_INVALID_REFERENCE;
  948. return GlobalAPIWrapper_NoRecord([&]() -> JsErrorCode {
  949. Memory::RecyclerWeakReference<char>* recyclerWeakReference =
  950. reinterpret_cast<Memory::RecyclerWeakReference<char>*>(weakRef);
  951. *value = reinterpret_cast<JsValueRef>(recyclerWeakReference->Get());
  952. return JsNoError;
  953. });
  954. }
  955. CHAKRA_API JsGetAndClearExceptionWithMetadata(_Out_ JsValueRef *metadata)
  956. {
  957. PARAM_NOT_NULL(metadata);
  958. *metadata = nullptr;
  959. JsrtContext *currentContext = JsrtContext::GetCurrent();
  960. if (currentContext == nullptr)
  961. {
  962. return JsErrorNoCurrentContext;
  963. }
  964. Js::ScriptContext *scriptContext = currentContext->GetScriptContext();
  965. Assert(scriptContext != nullptr);
  966. if (scriptContext->GetRecycler() && scriptContext->GetRecycler()->IsHeapEnumInProgress())
  967. {
  968. return JsErrorHeapEnumInProgress;
  969. }
  970. else if (scriptContext->GetThreadContext()->IsInThreadServiceCallback())
  971. {
  972. return JsErrorInThreadServiceCallback;
  973. }
  974. if (scriptContext->GetThreadContext()->IsExecutionDisabled())
  975. {
  976. return JsErrorInDisabledState;
  977. }
  978. HRESULT hr = S_OK;
  979. Js::JavascriptExceptionObject *recordedException = nullptr;
  980. BEGIN_TRANSLATE_OOM_TO_HRESULT
  981. if (scriptContext->HasRecordedException())
  982. {
  983. recordedException = scriptContext->GetAndClearRecordedException();
  984. }
  985. END_TRANSLATE_OOM_TO_HRESULT(hr)
  986. if (hr == E_OUTOFMEMORY)
  987. {
  988. recordedException = scriptContext->GetThreadContext()->GetRecordedException();
  989. }
  990. if (recordedException == nullptr)
  991. {
  992. return JsErrorInvalidArgument;
  993. }
  994. Js::Var exception = recordedException->GetThrownObject(nullptr);
  995. if (exception == nullptr)
  996. {
  997. // TODO: How does this early bailout impact TTD?
  998. return JsErrorInvalidArgument;
  999. }
  1000. return ContextAPIWrapper<false>([&](Js::ScriptContext* scriptContext, TTDRecorder& _actionEntryPopper) -> JsErrorCode {
  1001. Js::Var exceptionMetadata = Js::JavascriptExceptionMetadata::CreateMetadataVar(scriptContext);
  1002. Js::JavascriptOperators::OP_SetProperty(exceptionMetadata, Js::PropertyIds::exception, exception, scriptContext);
  1003. Js::FunctionBody *functionBody = recordedException->GetFunctionBody();
  1004. if (functionBody == nullptr)
  1005. {
  1006. // This is probably a parse error. We can get the error location metadata from the thrown object.
  1007. Js::JavascriptExceptionMetadata::PopulateMetadataFromCompileException(exceptionMetadata, exception, scriptContext);
  1008. }
  1009. else
  1010. {
  1011. if (!Js::JavascriptExceptionMetadata::PopulateMetadataFromException(exceptionMetadata, recordedException, scriptContext))
  1012. {
  1013. return JsErrorInvalidArgument;
  1014. }
  1015. }
  1016. *metadata = exceptionMetadata;
  1017. #if ENABLE_TTD
  1018. if (hr != E_OUTOFMEMORY)
  1019. {
  1020. PERFORM_JSRT_TTD_RECORD_ACTION(scriptContext, RecordJsRTGetAndClearExceptionWithMetadata);
  1021. PERFORM_JSRT_TTD_RECORD_ACTION_RESULT(scriptContext, metadata);
  1022. }
  1023. #endif
  1024. return JsNoError;
  1025. });
  1026. }
  1027. CHAKRA_API JsGetDataViewInfo(
  1028. _In_ JsValueRef dataView,
  1029. _Out_opt_ JsValueRef *arrayBuffer,
  1030. _Out_opt_ unsigned int *byteOffset,
  1031. _Out_opt_ unsigned int *byteLength)
  1032. {
  1033. VALIDATE_JSREF(dataView);
  1034. BEGIN_JSRT_NO_EXCEPTION
  1035. {
  1036. if (!Js::VarIs<Js::DataView>(dataView))
  1037. {
  1038. RETURN_NO_EXCEPTION(JsErrorInvalidArgument);
  1039. }
  1040. Js::DataView* dv = Js::VarTo<Js::DataView>(dataView);
  1041. if (arrayBuffer != nullptr) {
  1042. *arrayBuffer = dv->GetArrayBuffer();
  1043. }
  1044. if (byteOffset != nullptr) {
  1045. *byteOffset = dv->GetByteOffset();
  1046. }
  1047. if (byteLength != nullptr) {
  1048. *byteLength = dv->GetLength();
  1049. }
  1050. }
  1051. #if ENABLE_TTD
  1052. Js::ScriptContext* scriptContext = Js::VarTo<Js::RecyclableObject>(dataView)->GetScriptContext();
  1053. if (PERFORM_JSRT_TTD_RECORD_ACTION_CHECK(scriptContext) && arrayBuffer != nullptr)
  1054. {
  1055. scriptContext->GetThreadContext()->TTDLog->RecordJsRTGetDataViewInfo(dataView, *arrayBuffer);
  1056. }
  1057. #endif
  1058. END_JSRT_NO_EXCEPTION
  1059. }
  1060. CHAKRA_API JsSetHostPromiseRejectionTracker(_In_ JsHostPromiseRejectionTrackerCallback promiseRejectionTrackerCallback, _In_opt_ void *callbackState)
  1061. {
  1062. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1063. scriptContext->GetLibrary()->SetNativeHostPromiseRejectionTrackerCallback((Js::JavascriptLibrary::HostPromiseRejectionTrackerCallback) promiseRejectionTrackerCallback, callbackState);
  1064. return JsNoError;
  1065. },
  1066. /*allowInObjectBeforeCollectCallback*/true);
  1067. }
  1068. CHAKRA_API JsGetProxyProperties(_In_ JsValueRef object, _Out_ bool* isProxy, _Out_opt_ JsValueRef* target, _Out_opt_ JsValueRef* handler)
  1069. {
  1070. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext * scriptContext) -> JsErrorCode {
  1071. VALIDATE_INCOMING_REFERENCE(object, scriptContext);
  1072. PARAM_NOT_NULL(isProxy);
  1073. if (target != nullptr)
  1074. {
  1075. *target = JS_INVALID_REFERENCE;
  1076. }
  1077. if (handler != nullptr)
  1078. {
  1079. *handler = JS_INVALID_REFERENCE;
  1080. }
  1081. *isProxy = Js::VarIs<Js::JavascriptProxy>(object);
  1082. if (!*isProxy)
  1083. {
  1084. return JsNoError;
  1085. }
  1086. Js::JavascriptProxy* proxy = Js::UnsafeVarTo<Js::JavascriptProxy>(object);
  1087. bool revoked = proxy->IsRevoked();
  1088. if (target != nullptr && !revoked)
  1089. {
  1090. *target = static_cast<JsValueRef>(proxy->GetTarget());
  1091. }
  1092. if (handler != nullptr && !revoked)
  1093. {
  1094. *handler = static_cast<JsValueRef>(proxy->GetHandler());
  1095. }
  1096. return JsNoError;
  1097. },
  1098. /*allowInObjectBeforeCollectCallback*/true);
  1099. }
  1100. CHAKRA_API JsSetRuntimeBeforeSweepCallback(_In_ JsRuntimeHandle runtimeHandle, _In_opt_ void *callbackState, _In_ JsBeforeSweepCallback beforeSweepCallback)
  1101. {
  1102. return GlobalAPIWrapper_NoRecord([&]() -> JsErrorCode {
  1103. VALIDATE_INCOMING_RUNTIME_HANDLE(runtimeHandle);
  1104. JsrtRuntime::FromHandle(runtimeHandle)->SetBeforeSweepCallback(beforeSweepCallback, callbackState);
  1105. return JsNoError;
  1106. });
  1107. }
  1108. CHAKRA_API
  1109. JsSetRuntimeDomWrapperTracingCallbacks(
  1110. _In_ JsRuntimeHandle runtimeHandle,
  1111. _In_ JsRef wrapperTracingState,
  1112. _In_ JsDOMWrapperTracingCallback wrapperTracingCallback,
  1113. _In_ JsDOMWrapperTracingDoneCallback wrapperTracingDoneCallback,
  1114. _In_ JsDOMWrapperTracingEnterFinalPauseCallback enterFinalPauseCallback)
  1115. {
  1116. return GlobalAPIWrapper_NoRecord([&]() -> JsErrorCode {
  1117. VALIDATE_INCOMING_RUNTIME_HANDLE(runtimeHandle);
  1118. ThreadContext * threadContext = JsrtRuntime::FromHandle(runtimeHandle)->GetThreadContext();
  1119. ThreadContextScope scope(threadContext);
  1120. if (!scope.IsValid())
  1121. {
  1122. return JsErrorWrongThread;
  1123. }
  1124. Recycler * recycler = threadContext->GetRecycler();
  1125. recycler->SetDOMWrapperTracingCallback(wrapperTracingState, reinterpret_cast<DOMWrapperTracingCallback>(wrapperTracingCallback), reinterpret_cast<DOMWrapperTracingDoneCallback>(wrapperTracingDoneCallback), reinterpret_cast<DOMWrapperTracingEnterFinalPauseCallback>(enterFinalPauseCallback));
  1126. return JsNoError;
  1127. });
  1128. }
  1129. CHAKRA_API
  1130. JsGetArrayForEachFunction(_Out_ JsValueRef * result)
  1131. {
  1132. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1133. PARAM_NOT_NULL(result);
  1134. *result = scriptContext->GetLibrary()->EnsureArrayPrototypeForEachFunction();
  1135. return JsNoError;
  1136. },
  1137. /*allowInObjectBeforeCollectCallback*/true);
  1138. }
  1139. CHAKRA_API
  1140. JsGetArrayKeysFunction(_Out_ JsValueRef * result)
  1141. {
  1142. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1143. PARAM_NOT_NULL(result);
  1144. *result = scriptContext->GetLibrary()->EnsureArrayPrototypeKeysFunction();
  1145. return JsNoError;
  1146. },
  1147. /*allowInObjectBeforeCollectCallback*/true);
  1148. }
  1149. CHAKRA_API
  1150. JsGetArrayValuesFunction(_Out_ JsValueRef * result)
  1151. {
  1152. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1153. PARAM_NOT_NULL(result);
  1154. *result = scriptContext->GetLibrary()->EnsureArrayPrototypeValuesFunction();
  1155. return JsNoError;
  1156. },
  1157. /*allowInObjectBeforeCollectCallback*/true);
  1158. }
  1159. CHAKRA_API
  1160. JsGetArrayEntriesFunction(_Out_ JsValueRef * result)
  1161. {
  1162. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1163. PARAM_NOT_NULL(result);
  1164. *result = scriptContext->GetLibrary()->EnsureArrayPrototypeEntriesFunction();
  1165. return JsNoError;
  1166. },
  1167. /*allowInObjectBeforeCollectCallback*/true);
  1168. }
  1169. CHAKRA_API
  1170. JsGetPropertyIdSymbolIterator(_Out_ JsPropertyIdRef * propertyId)
  1171. {
  1172. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1173. PARAM_NOT_NULL(propertyId);
  1174. Js::PropertyId symbolIteratorPropertyId = scriptContext->GetLibrary()->GetPropertyIdSymbolIterator();
  1175. *propertyId = Js::JavascriptNumber::ToVar(symbolIteratorPropertyId, scriptContext);
  1176. return JsNoError;
  1177. },
  1178. /*allowInObjectBeforeCollectCallback*/true);
  1179. }
  1180. CHAKRA_API
  1181. JsGetErrorPrototype(_Out_ JsValueRef * result)
  1182. {
  1183. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1184. PARAM_NOT_NULL(result);
  1185. *result = scriptContext->GetLibrary()->GetErrorPrototype();
  1186. if (*result == JS_INVALID_REFERENCE)
  1187. {
  1188. return JsErrorFatal;
  1189. }
  1190. return JsNoError;
  1191. },
  1192. /*allowInObjectBeforeCollectCallback*/true);
  1193. }
  1194. CHAKRA_API
  1195. JsGetIteratorPrototype(_Out_ JsValueRef * result)
  1196. {
  1197. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1198. PARAM_NOT_NULL(result);
  1199. *result = scriptContext->GetLibrary()->GetIteratorPrototype();
  1200. if (*result == JS_INVALID_REFERENCE)
  1201. {
  1202. return JsErrorFatal;
  1203. }
  1204. return JsNoError;
  1205. },
  1206. /*allowInObjectBeforeCollectCallback*/true);
  1207. }
  1208. CHAKRA_API JsTraceExternalReference(_In_ JsRuntimeHandle runtimeHandle, _In_ JsValueRef value)
  1209. {
  1210. return GlobalAPIWrapper_NoRecord([&]() -> JsErrorCode {
  1211. VALIDATE_INCOMING_RUNTIME_HANDLE(runtimeHandle);
  1212. ThreadContext * threadContext = JsrtRuntime::FromHandle(runtimeHandle)->GetThreadContext();
  1213. ThreadContextScope scope(threadContext);
  1214. if (!scope.IsValid())
  1215. {
  1216. return JsErrorWrongThread;
  1217. }
  1218. Recycler * recycler = threadContext->GetRecycler();
  1219. recycler->TryExternalMarkNonInterior(value);
  1220. return JsNoError;
  1221. });
  1222. }
  1223. CHAKRA_API JsAllocRawData(_In_ JsRuntimeHandle runtimeHandle, _In_ size_t sizeInBytes, _In_ bool zeroed, _Out_ JsRef * buffer)
  1224. {
  1225. PARAM_NOT_NULL(buffer);
  1226. return GlobalAPIWrapper_NoRecord([&]() -> JsErrorCode {
  1227. VALIDATE_INCOMING_RUNTIME_HANDLE(runtimeHandle);
  1228. ThreadContext * threadContext = JsrtRuntime::FromHandle(runtimeHandle)->GetThreadContext();
  1229. ThreadContextScope scope(threadContext);
  1230. if (!scope.IsValid())
  1231. {
  1232. return JsErrorWrongThread;
  1233. }
  1234. Recycler * recycler = threadContext->GetRecycler();
  1235. *buffer = zeroed
  1236. ? RecyclerNewArrayZ(recycler, char, sizeInBytes)
  1237. : RecyclerNewArray(recycler, char, sizeInBytes);
  1238. return JsNoError;
  1239. });
  1240. }
  1241. CHAKRA_API JsIsCallable(_In_ JsValueRef object, _Out_ bool *isCallable)
  1242. {
  1243. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1244. VALIDATE_INCOMING_OBJECT(object, scriptContext);
  1245. PARAM_NOT_NULL(isCallable);
  1246. *isCallable = Js::JavascriptConversion::IsCallable(object) && !Js::JavascriptOperators::IsClassConstructor(object);
  1247. return JsNoError;
  1248. });
  1249. }
  1250. CHAKRA_API JsIsConstructor(_In_ JsValueRef object, _Out_ bool *isConstructor)
  1251. {
  1252. return ContextAPINoScriptWrapper_NoRecord([&](Js::ScriptContext *scriptContext) -> JsErrorCode {
  1253. VALIDATE_INCOMING_OBJECT(object, scriptContext);
  1254. PARAM_NOT_NULL(isConstructor);
  1255. *isConstructor = Js::JavascriptOperators::IsConstructor(object);
  1256. return JsNoError;
  1257. });
  1258. }
  1259. CHAKRA_API
  1260. JsQueueBackgroundParse_Experimental(
  1261. _In_ JsScriptContents* contents,
  1262. _Out_ DWORD* dwBgParseCookie)
  1263. {
  1264. HRESULT hr;
  1265. if (Js::Configuration::Global.flags.BgParse && !CONFIG_FLAG(ForceDiagnosticsMode)
  1266. // For now, only UTF8 buffers are supported for BGParse
  1267. && contents->encodingType == JsScriptEncodingType::Utf8
  1268. && contents->containerType == JsScriptContainerType::HeapAllocatedBuffer
  1269. // SourceContext not needed for BGParse
  1270. && contents->sourceContext == 0)
  1271. {
  1272. hr = BGParseManager::GetBGParseManager()->QueueBackgroundParse((LPUTF8)contents->container, contents->contentLengthInBytes, (char16*)contents->fullPath, dwBgParseCookie);
  1273. }
  1274. else
  1275. {
  1276. hr = E_NOTIMPL;
  1277. }
  1278. JsErrorCode res = (hr == S_OK) ? JsNoError : JsErrorFatal;
  1279. return res;
  1280. }
  1281. CHAKRA_API
  1282. JsDiscardBackgroundParse_Experimental(
  1283. _In_ DWORD dwBgParseCookie,
  1284. _In_ void* buffer,
  1285. _Out_ bool* callerOwnsBuffer)
  1286. {
  1287. (*callerOwnsBuffer) = BGParseManager::GetBGParseManager()->DiscardParseResults(dwBgParseCookie, buffer);
  1288. return JsNoError;
  1289. }
  1290. #ifdef _WIN32
  1291. CHAKRA_API
  1292. JsEnableOOPJIT()
  1293. {
  1294. #ifdef ENABLE_OOP_NATIVE_CODEGEN
  1295. JITManager::GetJITManager()->EnableOOPJIT();
  1296. return JsNoError;
  1297. #else
  1298. return JsErrorNotImplemented;
  1299. #endif
  1300. }
  1301. CHAKRA_API
  1302. JsConnectJITProcess(_In_ HANDLE processHandle, _In_opt_ void* serverSecurityDescriptor, _In_ UUID connectionId)
  1303. {
  1304. #ifdef ENABLE_OOP_NATIVE_CODEGEN
  1305. JITManager::GetJITManager()->EnableOOPJIT();
  1306. ThreadContext::SetJITConnectionInfo(processHandle, serverSecurityDescriptor, connectionId);
  1307. return JsNoError;
  1308. #else
  1309. return JsErrorNotImplemented;
  1310. #endif
  1311. }
  1312. #endif
  1313. CHAKRA_API
  1314. JsGetArrayBufferFreeFunction(
  1315. _In_ JsValueRef arrayBuffer,
  1316. _Out_ ArrayBufferFreeFn* freeFn)
  1317. {
  1318. VALIDATE_JSREF(arrayBuffer);
  1319. PARAM_NOT_NULL(freeFn);
  1320. return ContextAPINoScriptWrapper_NoRecord(
  1321. [&](Js::ScriptContext* scriptContext) -> JsErrorCode {
  1322. if (!Js::VarIs<Js::ArrayBuffer>(arrayBuffer))
  1323. {
  1324. return JsErrorInvalidArgument;
  1325. }
  1326. *freeFn = Js::VarTo<Js::ArrayBuffer>(arrayBuffer)->GetArrayBufferFreeFn();
  1327. return JsNoError;
  1328. });
  1329. }