AbstractOperations.cpp 81 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994
  1. /*
  2. * Copyright (c) 2022, Linus Groh <linusg@serenityos.org>
  3. * Copyright (c) 2023, Matthew Olsson <mattco@serenityos.org>
  4. *
  5. * SPDX-License-Identifier: BSD-2-Clause
  6. */
  7. #include <LibJS/Runtime/PromiseCapability.h>
  8. #include <LibJS/Runtime/PromiseConstructor.h>
  9. #include <LibWeb/Bindings/ExceptionOrUtils.h>
  10. #include <LibWeb/DOM/AbortSignal.h>
  11. #include <LibWeb/Streams/AbstractOperations.h>
  12. #include <LibWeb/Streams/ReadableByteStreamController.h>
  13. #include <LibWeb/Streams/ReadableStream.h>
  14. #include <LibWeb/Streams/ReadableStreamDefaultController.h>
  15. #include <LibWeb/Streams/ReadableStreamDefaultReader.h>
  16. #include <LibWeb/Streams/ReadableStreamGenericReader.h>
  17. #include <LibWeb/Streams/UnderlyingSink.h>
  18. #include <LibWeb/Streams/UnderlyingSource.h>
  19. #include <LibWeb/Streams/WritableStream.h>
  20. #include <LibWeb/Streams/WritableStreamDefaultController.h>
  21. #include <LibWeb/Streams/WritableStreamDefaultWriter.h>
  22. #include <LibWeb/WebIDL/AbstractOperations.h>
  23. #include <LibWeb/WebIDL/ExceptionOr.h>
  24. #include <LibWeb/WebIDL/Promise.h>
  25. namespace Web::Streams {
  26. // https://streams.spec.whatwg.org/#acquire-readable-stream-reader
  27. WebIDL::ExceptionOr<JS::NonnullGCPtr<ReadableStreamDefaultReader>> acquire_readable_stream_default_reader(ReadableStream& stream)
  28. {
  29. auto& realm = stream.realm();
  30. // 1. Let reader be a new ReadableStreamDefaultReader.
  31. auto reader = TRY(realm.heap().allocate<ReadableStreamDefaultReader>(realm, realm));
  32. // 2. Perform ? SetUpReadableStreamDefaultReader(reader, stream).
  33. TRY(set_up_readable_stream_default_reader(reader, stream));
  34. // 3. Return reader.
  35. return reader;
  36. }
  37. // https://streams.spec.whatwg.org/#is-readable-stream-locked
  38. bool is_readable_stream_locked(ReadableStream const& stream)
  39. {
  40. // 1. If stream.[[reader]] is undefined, return false.
  41. if (!stream.reader())
  42. return false;
  43. // 2. Return true.
  44. return true;
  45. }
  46. // https://streams.spec.whatwg.org/#readable-stream-cancel
  47. WebIDL::ExceptionOr<JS::NonnullGCPtr<WebIDL::Promise>> readable_stream_cancel(ReadableStream& stream, JS::Value reason)
  48. {
  49. auto& realm = stream.realm();
  50. // 1. Set stream.[[disturbed]] to true.
  51. stream.set_disturbed(true);
  52. // 2. If stream.[[state]] is "closed", return a promise resolved with undefined.
  53. if (stream.is_closed())
  54. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  55. // 3. If stream.[[state]] is "errored", return a promise rejected with stream.[[storedError]].
  56. if (stream.is_errored())
  57. return WebIDL::create_rejected_promise(realm, stream.stored_error());
  58. // 4. Perform ! ReadableStreamClose(stream).
  59. readable_stream_close(stream);
  60. // 5. Let reader be stream.[[reader]].
  61. auto reader = stream.reader();
  62. // FIXME:
  63. // 6. If reader is not undefined and reader implements ReadableStreamBYOBReader,
  64. // 1. Let readIntoRequests be reader.[[readIntoRequests]].
  65. // 2. Set reader.[[readIntoRequests]] to an empty list.
  66. // 3. For each readIntoRequest of readIntoRequests,
  67. // 1. Perform readIntoRequest’s close steps, given undefined.
  68. (void)reader;
  69. // 7. Let sourceCancelPromise be ! stream.[[controller]].[[CancelSteps]](reason).
  70. auto source_cancel_promise = MUST(stream.controller()->cancel_steps(reason));
  71. // 8. Return the result of reacting to sourceCancelPromise with a fulfillment step that returns undefined.
  72. auto react_result = WebIDL::react_to_promise(*source_cancel_promise,
  73. [](auto const&) -> WebIDL::ExceptionOr<JS::Value> { return JS::js_undefined(); },
  74. {});
  75. return WebIDL::create_resolved_promise(realm, react_result);
  76. }
  77. // https://streams.spec.whatwg.org/#readable-stream-fulfill-read-request
  78. void readable_stream_fulfill_read_request(ReadableStream& stream, JS::Value chunk, bool done)
  79. {
  80. // 1. Assert: ! ReadableStreamHasDefaultReader(stream) is true.
  81. VERIFY(readable_stream_has_default_reader(stream));
  82. // 2. Let reader be stream.[[reader]].
  83. auto& reader = *stream.reader();
  84. // 3. Assert: reader.[[readRequests]] is not empty.
  85. VERIFY(!reader.read_requests().is_empty());
  86. // 4. Let readRequest be reader.[[readRequests]][0].
  87. // 5. Remove readRequest from reader.[[readRequests]].
  88. auto read_request = reader.read_requests().take_first();
  89. // 6. If done is true, perform readRequest’s close steps.
  90. if (done) {
  91. read_request->on_close();
  92. }
  93. // 7. Otherwise, perform readRequest’s chunk steps, given chunk.
  94. else {
  95. read_request->on_chunk(chunk);
  96. }
  97. }
  98. // https://streams.spec.whatwg.org/#readable-stream-get-num-read-requests
  99. size_t readable_stream_get_num_read_requests(ReadableStream& stream)
  100. {
  101. // 1. Assert: ! ReadableStreamHasDefaultReader(stream) is true.
  102. VERIFY(readable_stream_has_default_reader(stream));
  103. // 2. Return stream.[[reader]].[[readRequests]]'s size.
  104. return stream.reader()->read_requests().size();
  105. }
  106. // https://streams.spec.whatwg.org/#readable-stream-has-default-reader
  107. bool readable_stream_has_default_reader(ReadableStream& stream)
  108. {
  109. // 1. Let reader be stream.[[reader]].
  110. auto reader = stream.reader();
  111. // 2. If reader is undefined, return false.
  112. if (!reader)
  113. return false;
  114. // 3. If reader implements ReadableStreamDefaultReader, return true.
  115. if (reader->is_default_reader())
  116. return true;
  117. // 4. Return false.
  118. return false;
  119. }
  120. // https://streams.spec.whatwg.org/#readable-stream-close
  121. void readable_stream_close(ReadableStream& stream)
  122. {
  123. auto& realm = stream.realm();
  124. // 1. Assert: stream.[[state]] is "readable".
  125. VERIFY(stream.is_readable());
  126. // 2. Set stream.[[state]] to "closed".
  127. stream.set_stream_state(ReadableStream::State::Closed);
  128. // 3. Let reader be stream.[[reader]].
  129. auto reader = stream.reader();
  130. // 4. If reader is undefined, return.
  131. if (!reader)
  132. return;
  133. // 5. Resolve reader.[[closedPromise]] with undefined.
  134. WebIDL::resolve_promise(realm, *reader->closed_promise_capability());
  135. // 6. If reader implements ReadableStreamDefaultReader,
  136. if (reader->is_default_reader()) {
  137. // 1. Let readRequests be reader.[[readRequests]].
  138. // 2. Set reader.[[readRequests]] to an empty list.
  139. auto read_requests = move(reader->read_requests());
  140. // 3. For each readRequest of readRequests,
  141. for (auto& read_request : read_requests) {
  142. // 1. Perform readRequest’s close steps.
  143. read_request->on_close();
  144. }
  145. }
  146. }
  147. // https://streams.spec.whatwg.org/#readable-stream-error
  148. void readable_stream_error(ReadableStream& stream, JS::Value error)
  149. {
  150. auto& realm = stream.realm();
  151. // 1. Assert: stream.[[state]] is "readable".
  152. VERIFY(stream.is_readable());
  153. // 2. Set stream.[[state]] to "errored".
  154. stream.set_stream_state(ReadableStream::State::Errored);
  155. // 3. Set stream.[[storedError]] to e.
  156. stream.set_stored_error(error);
  157. // 4. Let reader be stream.[[reader]].
  158. auto reader = stream.reader();
  159. // 5. If reader is undefined, return.
  160. if (!reader)
  161. return;
  162. // 6. Reject reader.[[closedPromise]] with e.
  163. WebIDL::reject_promise(realm, *reader->closed_promise_capability(), error);
  164. // 7. Set reader.[[closedPromise]].[[PromiseIsHandled]] to true.
  165. WebIDL::mark_promise_as_handled(*reader->closed_promise_capability());
  166. // 8. If reader implements ReadableStreamDefaultReader,
  167. if (reader->is_default_reader()) {
  168. // 1. Perform ! ReadableStreamDefaultReaderErrorReadRequests(reader, e).
  169. readable_stream_default_reader_error_read_requests(*reader, error);
  170. }
  171. // 9. Otherwise,
  172. else {
  173. // 1. Assert: reader implements ReadableStreamBYOBReader.
  174. // 2. Perform ! ReadableStreamBYOBReaderErrorReadIntoRequests(reader, e).
  175. // FIXME: Handle BYOBReader
  176. TODO();
  177. }
  178. }
  179. // https://streams.spec.whatwg.org/#readable-stream-add-read-request
  180. void readable_stream_add_read_request(ReadableStream& stream, ReadRequest const& read_request)
  181. {
  182. // FIXME: Check implementation type
  183. // 1. Assert: stream.[[reader]] implements ReadableStreamDefaultReader.
  184. VERIFY(stream.reader());
  185. // 2. Assert: stream.[[state]] is "readable".
  186. VERIFY(stream.is_readable());
  187. // 3. Append readRequest to stream.[[reader]].[[readRequests]].
  188. stream.reader()->read_requests().append(read_request);
  189. }
  190. // https://streams.spec.whatwg.org/#readable-stream-reader-generic-cancel
  191. JS::NonnullGCPtr<WebIDL::Promise> readable_stream_reader_generic_cancel(ReadableStreamGenericReaderMixin& reader, JS::Value reason)
  192. {
  193. // 1. Let stream be reader.[[stream]]
  194. auto stream = reader.stream();
  195. // 2. Assert: stream is not undefined
  196. VERIFY(stream);
  197. // 3. Return ! ReadableStreamCancel(stream, reason)
  198. return MUST(readable_stream_cancel(*stream, reason));
  199. }
  200. // https://streams.spec.whatwg.org/#readable-stream-reader-generic-initialize
  201. void readable_stream_reader_generic_initialize(ReadableStreamGenericReaderMixin& reader, ReadableStream& stream)
  202. {
  203. auto& realm = stream.realm();
  204. // 1. Set reader.[[stream]] to stream.
  205. reader.set_stream(stream);
  206. // 2. Set stream.[[reader]] to reader.
  207. if (reader.is_default_reader()) {
  208. stream.set_reader(static_cast<ReadableStreamDefaultReader&>(reader));
  209. } else {
  210. // FIXME: Handle other descendents of ReadableStreamGenericReaderMixin (i.e. BYOBReader)
  211. TODO();
  212. }
  213. // 3. If stream.[[state]] is "readable",
  214. if (stream.is_readable()) {
  215. // 1. Set reader.[[closedPromise]] to a new promise.
  216. reader.set_closed_promise_capability(WebIDL::create_promise(realm));
  217. }
  218. // 4. Otherwise, if stream.[[state]] is "closed",
  219. else if (stream.is_closed()) {
  220. // 1. Set reader.[[closedPromise]] to a promise resolved with undefined.
  221. reader.set_closed_promise_capability(WebIDL::create_resolved_promise(realm, JS::js_undefined()));
  222. }
  223. // 5. Otherwise,
  224. else {
  225. // 1. Assert: stream.[[state]] is "errored".
  226. VERIFY(stream.is_errored());
  227. // 2. Set reader.[[closedPromise]] to a promise rejected with stream.[[storedError]].
  228. reader.set_closed_promise_capability(WebIDL::create_rejected_promise(realm, stream.stored_error()));
  229. // 3. Set reader.[[closedPromise]].[[PromiseIsHandled]] to true.
  230. WebIDL::mark_promise_as_handled(*reader.closed_promise_capability());
  231. }
  232. }
  233. // https://streams.spec.whatwg.org/#readable-stream-reader-generic-release
  234. WebIDL::ExceptionOr<void> readable_stream_reader_generic_release(ReadableStreamGenericReaderMixin& reader)
  235. {
  236. // 1. Let stream be reader.[[stream]].
  237. auto stream = reader.stream();
  238. // 2. Assert: stream is not undefined.
  239. VERIFY(stream);
  240. // 3. Assert: stream.[[reader]] is reader.
  241. VERIFY(stream->reader().ptr() == &reader);
  242. auto& realm = stream->realm();
  243. // 4. If stream.[[state]] is "readable", reject reader.[[closedPromise]] with a TypeError exception.
  244. auto exception = TRY(JS::TypeError::create(realm, "Released readable stream"sv));
  245. if (stream->is_readable()) {
  246. WebIDL::reject_promise(realm, *reader.closed_promise_capability(), exception);
  247. }
  248. // 5. Otherwise, set reader.[[closedPromise]] to a promise rejected with a TypeError exception.
  249. else {
  250. reader.set_closed_promise_capability(WebIDL::create_rejected_promise(realm, exception));
  251. }
  252. // 6. Set reader.[[closedPromise]].[[PromiseIsHandled]] to true.
  253. WebIDL::mark_promise_as_handled(*reader.closed_promise_capability());
  254. // 7. Perform ! stream.[[controller]].[[ReleaseSteps]]().
  255. stream->controller()->release_steps();
  256. // 8. Set stream.[[reader]] to undefined.
  257. stream->set_reader({});
  258. // 9. Set reader.[[stream]] to undefined.
  259. reader.set_stream({});
  260. return {};
  261. }
  262. // https://streams.spec.whatwg.org/#abstract-opdef-readablestreamdefaultreadererrorreadrequests
  263. void readable_stream_default_reader_error_read_requests(ReadableStreamDefaultReader& reader, JS::Value error)
  264. {
  265. // 1. Let readRequests be reader.[[readRequests]].
  266. // 2. Set reader.[[readRequests]] to a new empty list.
  267. auto read_requests = move(reader.read_requests());
  268. // 3. For each readRequest of readRequests,
  269. for (auto& read_request : read_requests) {
  270. // 1. Perform readRequest’s error steps, given e.
  271. read_request->on_error(error);
  272. }
  273. }
  274. // https://streams.spec.whatwg.org/#readable-stream-default-reader-read
  275. void readable_stream_default_reader_read(ReadableStreamDefaultReader& reader, ReadRequest& read_request)
  276. {
  277. // 1. Let stream be reader.[[stream]].
  278. auto stream = reader.stream();
  279. // 2. Assert: stream is not undefined.
  280. VERIFY(stream);
  281. // 3. Set stream.[[disturbed]] to true.
  282. stream->set_disturbed(true);
  283. // 4. If stream.[[state]] is "closed", perform readRequest’s close steps.
  284. if (stream->is_closed()) {
  285. read_request.on_close();
  286. }
  287. // 5. Otherwise, if stream.[[state]] is "errored", perform readRequest’s error steps given stream.[[storedError]].
  288. else if (stream->is_errored()) {
  289. read_request.on_error(stream->stored_error());
  290. }
  291. // 6. Otherwise,
  292. else {
  293. // 1. Assert: stream.[[state]] is "readable".
  294. VERIFY(stream->is_readable());
  295. // 2. Perform ! stream.[[controller]].[[PullSteps]](readRequest).
  296. MUST(stream->controller()->pull_steps(read_request));
  297. }
  298. }
  299. // https://streams.spec.whatwg.org/#abstract-opdef-readablestreamdefaultreaderrelease
  300. WebIDL::ExceptionOr<void> readable_stream_default_reader_release(ReadableStreamDefaultReader& reader)
  301. {
  302. auto& realm = reader.realm();
  303. // 1. Perform ! ReadableStreamReaderGenericRelease(reader).
  304. TRY(readable_stream_reader_generic_release(reader));
  305. // 2. Let e be a new TypeError exception.
  306. auto e = TRY(JS::TypeError::create(realm, "Reader has been released"sv));
  307. // 3. Perform ! ReadableStreamDefaultReaderErrorReadRequests(reader, e).
  308. readable_stream_default_reader_error_read_requests(reader, e);
  309. return {};
  310. }
  311. // https://streams.spec.whatwg.org/#set-up-readable-stream-default-reader
  312. WebIDL::ExceptionOr<void> set_up_readable_stream_default_reader(ReadableStreamDefaultReader& reader, ReadableStream& stream)
  313. {
  314. // 1. If ! IsReadableStreamLocked(stream) is true, throw a TypeError exception.
  315. if (is_readable_stream_locked(stream))
  316. return WebIDL::SimpleException { WebIDL::SimpleExceptionType::TypeError, "Cannot create stream reader for a locked stream"sv };
  317. // 2. Perform ! ReadableStreamReaderGenericInitialize(reader, stream).
  318. // 3. Set reader.[[readRequests]] to a new empty list.
  319. readable_stream_reader_generic_initialize(reader, stream);
  320. return {};
  321. }
  322. // https://streams.spec.whatwg.org/#readable-stream-default-controller-close
  323. void readable_stream_default_controller_close(ReadableStreamDefaultController& controller)
  324. {
  325. // 1. If ! ReadableStreamDefaultControllerCanCloseOrEnqueue(controller) is false, return.
  326. if (!readable_stream_default_controller_can_close_or_enqueue(controller))
  327. return;
  328. // 2. Let stream be controller.[[stream]].
  329. auto stream = controller.stream();
  330. // 3. Set controller.[[closeRequested]] to true.
  331. controller.set_close_requested(true);
  332. // 4. If controller.[[queue]] is empty,
  333. if (controller.queue().is_empty()) {
  334. // 1. Perform ! ReadableStreamDefaultControllerClearAlgorithms(controller).
  335. readable_stream_default_controller_clear_algorithms(controller);
  336. // 2. Perform ! ReadableStreamClose(stream).
  337. readable_stream_close(*stream);
  338. }
  339. }
  340. // https://streams.spec.whatwg.org/#readable-stream-default-controller-enqueue
  341. WebIDL::ExceptionOr<void> readable_stream_default_controller_enqueue(ReadableStreamDefaultController& controller, JS::Value chunk)
  342. {
  343. auto& vm = controller.vm();
  344. // 1. If ! ReadableStreamDefaultControllerCanCloseOrEnqueue(controller) is false, return.
  345. if (!readable_stream_default_controller_can_close_or_enqueue(controller))
  346. return {};
  347. // 2. Let stream be controller.[[stream]].
  348. auto stream = controller.stream();
  349. // 3. If ! IsReadableStreamLocked(stream) is true and ! ReadableStreamGetNumReadRequests(stream) > 0, perform ! ReadableStreamFulfillReadRequest(stream, chunk, false).
  350. if (is_readable_stream_locked(*stream) && readable_stream_get_num_read_requests(*stream) > 0) {
  351. readable_stream_fulfill_read_request(*stream, chunk, false);
  352. }
  353. // 4. Otherwise,
  354. else {
  355. // 1. Let result be the result of performing controller.[[strategySizeAlgorithm]], passing in chunk, and interpreting the result as a completion record.
  356. auto result = (*controller.strategy_size_algorithm())(chunk);
  357. // 2. If result is an abrupt completion,
  358. if (result.is_abrupt()) {
  359. // 1. Perform ! ReadableStreamDefaultControllerError(controller, result.[[Value]]).
  360. readable_stream_default_controller_error(controller, result.value().value());
  361. // 2. Return result.
  362. return result;
  363. }
  364. // 3. Let chunkSize be result.[[Value]].
  365. auto chunk_size = result.release_value().release_value();
  366. // 4. Let enqueueResult be EnqueueValueWithSize(controller, chunk, chunkSize).
  367. auto enqueue_result = enqueue_value_with_size(controller, chunk, chunk_size);
  368. // 5. If enqueueResult is an abrupt completion,
  369. if (enqueue_result.is_error()) {
  370. auto throw_completion = Bindings::throw_dom_exception_if_needed(vm, [&] { return enqueue_result; }).throw_completion();
  371. // 1. Perform ! ReadableStreamDefaultControllerError(controller, enqueueResult.[[Value]]).
  372. readable_stream_default_controller_error(controller, throw_completion.value().value());
  373. // 2. Return enqueueResult.
  374. return enqueue_result;
  375. }
  376. }
  377. // 5. Perform ! ReadableStreamDefaultControllerCallPullIfNeeded(controller).
  378. return readable_stream_default_controller_can_pull_if_needed(controller);
  379. }
  380. // https://streams.spec.whatwg.org/#readable-stream-default-controller-call-pull-if-needed
  381. WebIDL::ExceptionOr<void> readable_stream_default_controller_can_pull_if_needed(ReadableStreamDefaultController& controller)
  382. {
  383. // 1. Let shouldPull be ! ReadableStreamDefaultControllerShouldCallPull(controller).
  384. auto should_pull = readable_stream_default_controller_should_call_pull(controller);
  385. // 2. If shouldPull is false, return.
  386. if (!should_pull)
  387. return {};
  388. // 3. If controller.[[pulling]] is true,
  389. if (controller.pulling()) {
  390. // 1. Set controller.[[pullAgain]] to true.
  391. controller.set_pull_again(true);
  392. // 2. Return.
  393. return {};
  394. }
  395. // 4. Assert: controller.[[pullAgain]] is false.
  396. VERIFY(!controller.pull_again());
  397. // 5. Set controller.[[pulling]] to true.
  398. controller.set_pulling(true);
  399. // 6. Let pullPromise be the result of performing controller.[[pullAlgorithm]].
  400. auto pull_promise = TRY((*controller.pull_algorithm())());
  401. // 7. Upon fulfillment of pullPromise,
  402. WebIDL::upon_fulfillment(*pull_promise, [&](auto const&) -> WebIDL::ExceptionOr<JS::Value> {
  403. // 1. Set controller.[[pulling]] to false.
  404. controller.set_pulling(false);
  405. // 2. If controller.[[pullAgain]] is true,
  406. if (controller.pull_again()) {
  407. // 1. Set controller.[[pullAgain]] to false.
  408. controller.set_pull_again(false);
  409. // 2. Perform ! ReadableStreamDefaultControllerCallPullIfNeeded(controller).
  410. TRY(readable_stream_default_controller_can_pull_if_needed(controller));
  411. }
  412. return JS::js_undefined();
  413. });
  414. // 8. Upon rejection of pullPromise with reason e,
  415. WebIDL::upon_rejection(*pull_promise, [&](auto const& e) -> WebIDL::ExceptionOr<JS::Value> {
  416. // 1. Perform ! ReadableStreamDefaultControllerError(controller, e).
  417. readable_stream_default_controller_error(controller, e);
  418. return JS::js_undefined();
  419. });
  420. return {};
  421. }
  422. // https://streams.spec.whatwg.org/#readable-stream-default-controller-should-call-pull
  423. bool readable_stream_default_controller_should_call_pull(ReadableStreamDefaultController& controller)
  424. {
  425. // 1. Let stream be controller.[[stream]].
  426. auto stream = controller.stream();
  427. // 2. If ! ReadableStreamDefaultControllerCanCloseOrEnqueue(controller) is false, return false.
  428. if (!readable_stream_default_controller_can_close_or_enqueue(controller))
  429. return false;
  430. // 3. If controller.[[started]] is false, return false.
  431. if (!controller.started())
  432. return false;
  433. // 4. If ! IsReadableStreamLocked(stream) is true and ! ReadableStreamGetNumReadRequests(stream) > 0, return true.
  434. if (is_readable_stream_locked(*stream) && readable_stream_get_num_read_requests(*stream) > 0)
  435. return true;
  436. // 5. Let desiredSize be ! ReadableStreamDefaultControllerGetDesiredSize(controller).
  437. auto desired_size = readable_stream_default_controller_get_desired_size(controller);
  438. // 6. Assert: desiredSize is not null.
  439. VERIFY(desired_size.has_value());
  440. // 7. If desiredSize > 0, return true.
  441. if (desired_size.release_value() > 0)
  442. return true;
  443. // 8. Return false.
  444. return false;
  445. }
  446. // https://streams.spec.whatwg.org/#readable-stream-default-controller-clear-algorithms
  447. void readable_stream_default_controller_clear_algorithms(ReadableStreamDefaultController& controller)
  448. {
  449. // 1. Set controller.[[pullAlgorithm]] to undefined.
  450. controller.set_pull_algorithm({});
  451. // 2. Set controller.[[cancelAlgorithm]] to undefined.
  452. controller.set_cancel_algorithm({});
  453. // 3. Set controller.[[strategySizeAlgorithm]] to undefined.
  454. controller.set_strategy_size_algorithm({});
  455. }
  456. // https://streams.spec.whatwg.org/#readable-stream-default-controller-error
  457. void readable_stream_default_controller_error(ReadableStreamDefaultController& controller, JS::Value error)
  458. {
  459. // 1. Let stream be controller.[[stream]].
  460. auto stream = controller.stream();
  461. // 2. If stream.[[state]] is not "readable", return.
  462. if (!stream->is_readable())
  463. return;
  464. // 3. Perform ! ResetQueue(controller).
  465. reset_queue(controller);
  466. // 4. Perform ! ReadableStreamDefaultControllerClearAlgorithms(controller).
  467. readable_stream_default_controller_clear_algorithms(controller);
  468. // 5. Perform ! ReadableStreamError(stream, e).
  469. readable_stream_error(*stream, error);
  470. }
  471. // https://streams.spec.whatwg.org/#readable-stream-default-controller-get-desired-size
  472. Optional<float> readable_stream_default_controller_get_desired_size(ReadableStreamDefaultController& controller)
  473. {
  474. auto stream = controller.stream();
  475. // 1. Let state be controller.[[stream]].[[state]].
  476. // 2. If state is "errored", return null.
  477. if (stream->is_errored())
  478. return {};
  479. // 3. If state is "closed", return 0.
  480. if (stream->is_closed())
  481. return 0.0f;
  482. // 4. Return controller.[[strategyHWM]] − controller.[[queueTotalSize]].
  483. return controller.strategy_hwm() - controller.queue_total_size();
  484. }
  485. // https://streams.spec.whatwg.org/#readable-stream-default-controller-can-close-or-enqueue
  486. bool readable_stream_default_controller_can_close_or_enqueue(ReadableStreamDefaultController& controller)
  487. {
  488. // 1. Let state be controller.[[stream]].[[state]].
  489. // 2. If controller.[[closeRequested]] is false and state is "readable", return true.
  490. // 3. Otherwise, return false.
  491. return !controller.close_requested() && controller.stream()->is_readable();
  492. }
  493. // https://streams.spec.whatwg.org/#set-up-readable-stream-default-controller
  494. WebIDL::ExceptionOr<void> set_up_readable_stream_default_controller(ReadableStream& stream, ReadableStreamDefaultController& controller, StartAlgorithm&& start_algorithm, PullAlgorithm&& pull_algorithm, CancelAlgorithm&& cancel_algorithm, double high_water_mark, SizeAlgorithm&& size_algorithm)
  495. {
  496. auto& realm = stream.realm();
  497. // 1. Assert: stream.[[controller]] is undefined.
  498. VERIFY(!stream.controller());
  499. // 2. Set controller.[[stream]] to stream.
  500. controller.set_stream(stream);
  501. // 3. Perform ! ResetQueue(controller).
  502. reset_queue(controller);
  503. // 4. Set controller.[[started]], controller.[[closeRequested]], controller.[[pullAgain]], and controller.[[pulling]] to false.
  504. controller.set_started(false);
  505. controller.set_close_requested(false);
  506. controller.set_pull_again(false);
  507. controller.set_pulling(false);
  508. // 5. Set controller.[[strategySizeAlgorithm]] to sizeAlgorithm and controller.[[strategyHWM]] to highWaterMark.
  509. controller.set_strategy_size_algorithm(move(size_algorithm));
  510. controller.set_strategy_hwm(high_water_mark);
  511. // 6. Set controller.[[pullAlgorithm]] to pullAlgorithm.
  512. controller.set_pull_algorithm(move(pull_algorithm));
  513. // 7. Set controller.[[cancelAlgorithm]] to cancelAlgorithm.
  514. controller.set_cancel_algorithm(move(cancel_algorithm));
  515. // 8. Set stream.[[controller]] to controller.
  516. stream.set_controller(controller);
  517. // 9. Let startResult be the result of performing startAlgorithm. (This might throw an exception.)
  518. auto start_result = TRY(start_algorithm());
  519. // 10. Let startPromise be a promise resolved with startResult.
  520. auto start_promise = WebIDL::create_resolved_promise(realm, start_result ? start_result->promise() : JS::js_undefined());
  521. // 11. Upon fulfillment of startPromise,
  522. WebIDL::upon_fulfillment(start_promise, [&](auto const&) -> WebIDL::ExceptionOr<JS::Value> {
  523. // 1. Set controller.[[started]] to true.
  524. controller.set_started(true);
  525. // 2. Assert: controller.[[pulling]] is false.
  526. VERIFY(!controller.pulling());
  527. // 3. Assert: controller.[[pullAgain]] is false.
  528. VERIFY(!controller.pull_again());
  529. // 4. Perform ! ReadableStreamDefaultControllerCallPullIfNeeded(controller).
  530. TRY(readable_stream_default_controller_can_pull_if_needed(controller));
  531. return JS::js_undefined();
  532. });
  533. // 12. Upon rejection of startPromise with reason r,
  534. WebIDL::upon_rejection(start_promise, [&](auto const& r) -> WebIDL::ExceptionOr<JS::Value> {
  535. // 1. Perform ! ReadableStreamDefaultControllerError(controller, r).
  536. readable_stream_default_controller_error(controller, r);
  537. return JS::js_undefined();
  538. });
  539. return {};
  540. }
  541. // https://streams.spec.whatwg.org/#set-up-readable-stream-default-controller-from-underlying-source
  542. WebIDL::ExceptionOr<void> set_up_readable_stream_default_controller_from_underlying_source(ReadableStream& stream, JS::Value underlying_source_value, UnderlyingSource underlying_source, double high_water_mark, SizeAlgorithm&& size_algorithm)
  543. {
  544. auto& realm = stream.realm();
  545. // 1. Let controller be a new ReadableStreamDefaultController.
  546. auto controller = MUST_OR_THROW_OOM(stream.heap().allocate<ReadableStreamDefaultController>(realm, realm));
  547. // 2. Let startAlgorithm be an algorithm that returns undefined.
  548. StartAlgorithm start_algorithm = [] { return JS::GCPtr<WebIDL::Promise> {}; };
  549. // 3. Let pullAlgorithm be an algorithm that returns a promise resolved with undefined.
  550. PullAlgorithm pull_algorithm = [&realm]() {
  551. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  552. };
  553. // 4. Let cancelAlgorithm be an algorithm that returns a promise resolved with undefined.
  554. CancelAlgorithm cancel_algorithm = [&realm](auto const&) {
  555. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  556. };
  557. // 5. If underlyingSourceDict["start"] exists, then set startAlgorithm to an algorithm which returns the result of invoking underlyingSourceDict["start"] with argument list « controller » and callback this value underlyingSource.
  558. if (underlying_source.start) {
  559. start_algorithm = [&, start = underlying_source.start]() -> WebIDL::ExceptionOr<JS::GCPtr<WebIDL::Promise>> {
  560. auto result = TRY(WebIDL::invoke_callback(*start, underlying_source_value, controller)).release_value();
  561. return WebIDL::create_resolved_promise(realm, result);
  562. };
  563. }
  564. // 6. If underlyingSourceDict["pull"] exists, then set pullAlgorithm to an algorithm which returns the result of invoking underlyingSourceDict["pull"] with argument list « controller » and callback this value underlyingSource.
  565. if (underlying_source.pull) {
  566. pull_algorithm = [&, pull = underlying_source.pull]() -> WebIDL::ExceptionOr<JS::GCPtr<WebIDL::Promise>> {
  567. auto result = TRY(WebIDL::invoke_callback(*pull, underlying_source_value, controller)).release_value();
  568. return WebIDL::create_resolved_promise(realm, result);
  569. };
  570. }
  571. // 7. If underlyingSourceDict["cancel"] exists, then set cancelAlgorithm to an algorithm which takes an argument reason and returns the result of invoking underlyingSourceDict["cancel"] with argument list « reason » and callback this value underlyingSource.
  572. if (underlying_source.cancel) {
  573. cancel_algorithm = [&, cancel = underlying_source.cancel](auto const& reason) -> WebIDL::ExceptionOr<JS::GCPtr<WebIDL::Promise>> {
  574. auto result = TRY(WebIDL::invoke_callback(*cancel, underlying_source_value, reason)).release_value();
  575. return WebIDL::create_resolved_promise(realm, result);
  576. };
  577. }
  578. // 8. Perform ? SetUpReadableStreamDefaultController(stream, controller, startAlgorithm, pullAlgorithm, cancelAlgorithm, highWaterMark, sizeAlgorithm).
  579. return set_up_readable_stream_default_controller(stream, controller, move(start_algorithm), move(pull_algorithm), move(cancel_algorithm), high_water_mark, move(size_algorithm));
  580. }
  581. // https://streams.spec.whatwg.org/#readable-byte-stream-controller-get-desired-size
  582. Optional<double> readable_byte_stream_controller_get_desired_size(ReadableByteStreamController const& controller)
  583. {
  584. auto stream = controller.stream();
  585. // 1. Let state be controller.[[stream]].[[state]].
  586. // 2. If state is "errored", return null.
  587. if (stream->is_errored())
  588. return {};
  589. // 3. If state is "closed", return 0.
  590. if (stream->is_closed())
  591. return 0.0;
  592. // 4. Return controller.[[strategyHWM]] − controller.[[queueTotalSize]].
  593. return controller.strategy_hwm() - controller.queue_total_size();
  594. }
  595. // https://streams.spec.whatwg.org/#acquire-writable-stream-default-writer
  596. WebIDL::ExceptionOr<JS::NonnullGCPtr<WritableStreamDefaultWriter>> acquire_writable_stream_default_writer(WritableStream& stream)
  597. {
  598. auto& realm = stream.realm();
  599. // 1. Let writer be a new WritableStreamDefaultWriter.
  600. auto writer = MUST_OR_THROW_OOM(stream.heap().allocate<WritableStreamDefaultWriter>(realm, realm));
  601. // 2. Perform ? SetUpWritableStreamDefaultWriter(writer, stream).
  602. TRY(set_up_writable_stream_default_writer(*writer, stream));
  603. // 3. Return writer.
  604. return writer;
  605. }
  606. // https://streams.spec.whatwg.org/#is-writable-stream-locked
  607. bool is_writable_stream_locked(WritableStream const& stream)
  608. {
  609. // 1. If stream.[[writer]] is undefined, return false.
  610. if (!stream.writer())
  611. return false;
  612. // 2. Return true.
  613. return true;
  614. }
  615. // https://streams.spec.whatwg.org/#set-up-writable-stream-default-writer
  616. WebIDL::ExceptionOr<void> set_up_writable_stream_default_writer(WritableStreamDefaultWriter& writer, WritableStream& stream)
  617. {
  618. auto& realm = writer.realm();
  619. // 1. If ! IsWritableStreamLocked(stream) is true, throw a TypeError exception.
  620. if (is_writable_stream_locked(stream))
  621. return WebIDL::SimpleException { WebIDL::SimpleExceptionType::TypeError, "Stream is locked"sv };
  622. // 2. Set writer.[[stream]] to stream.
  623. writer.set_stream(stream);
  624. // 3. Set stream.[[writer]] to writer.
  625. stream.set_writer(writer);
  626. // 4. Let state be stream.[[state]].
  627. auto state = stream.state();
  628. // 5. If state is "writable",
  629. if (state == WritableStream::State::Writable) {
  630. // 1. If ! WritableStreamCloseQueuedOrInFlight(stream) is false and stream.[[backpressure]] is true, set writer.[[readyPromise]] to a new promise.
  631. if (!writable_stream_close_queued_or_in_flight(stream) && stream.backpressure()) {
  632. writer.set_ready_promise(WebIDL::create_promise(realm));
  633. }
  634. // 2. Otherwise, set writer.[[readyPromise]] to a promise resolved with undefined.
  635. else {
  636. writer.set_ready_promise(WebIDL::create_resolved_promise(realm, JS::js_undefined()));
  637. }
  638. // 3. Set writer.[[closedPromise]] to a new promise.
  639. writer.set_closed_promise(WebIDL::create_promise(realm));
  640. }
  641. // 6. Otherwise, if state is "erroring",
  642. else if (state == WritableStream::State::Erroring) {
  643. // 1. Set writer.[[readyPromise]] to a promise rejected with stream.[[storedError]].
  644. writer.set_ready_promise(WebIDL::create_rejected_promise(realm, stream.stored_error()));
  645. // 2. Set writer.[[readyPromise]].[[PromiseIsHandled]] to true.
  646. WebIDL::mark_promise_as_handled(*writer.ready_promise());
  647. // 3. Set writer.[[closedPromise]] to a new promise.
  648. writer.set_closed_promise(WebIDL::create_promise(realm));
  649. }
  650. // 7. Otherwise, if state is "closed",
  651. else if (state == WritableStream::State::Closed) {
  652. // 1. Set writer.[[readyPromise]] to a promise resolved with undefined.
  653. writer.set_ready_promise(WebIDL::create_resolved_promise(realm, JS::js_undefined()));
  654. // 2. Set writer.[[closedPromise]] to a promise resolved with undefined.
  655. writer.set_closed_promise(WebIDL::create_resolved_promise(realm, JS::js_undefined()));
  656. }
  657. // 8. Otherwise,
  658. else {
  659. // 1. Assert: state is "errored".
  660. VERIFY(state == WritableStream::State::Errored);
  661. // 2. Let storedError be stream.[[storedError]].
  662. auto stored_error = stream.stored_error();
  663. // 3. Set writer.[[readyPromise]] to a promise rejected with storedError.
  664. writer.set_ready_promise(WebIDL::create_rejected_promise(realm, stored_error));
  665. // 4. Set writer.[[readyPromise]].[[PromiseIsHandled]] to true.
  666. WebIDL::mark_promise_as_handled(*writer.ready_promise());
  667. // 5. Set writer.[[closedPromise]] to a promise rejected with storedError.
  668. writer.set_closed_promise(WebIDL::create_rejected_promise(realm, stored_error));
  669. // 6. Set writer.[[closedPromise]].[[PromiseIsHandled]] to true.
  670. WebIDL::mark_promise_as_handled(*writer.closed_promise());
  671. }
  672. return {};
  673. }
  674. // https://streams.spec.whatwg.org/#writable-stream-abort
  675. WebIDL::ExceptionOr<JS::NonnullGCPtr<WebIDL::Promise>> writable_stream_abort(WritableStream& stream, JS::Value reason)
  676. {
  677. auto& realm = stream.realm();
  678. // 1. If stream.[[state]] is "closed" or "errored", return a promise resolved with undefined.
  679. auto state = stream.state();
  680. if (state == WritableStream::State::Closed || state == WritableStream::State::Errored)
  681. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  682. // 2. Signal abort on stream.[[controller]].[[signal]] with reason.
  683. stream.controller()->signal()->signal_abort(reason);
  684. // 3. Let state be stream.[[state]].
  685. state = stream.state();
  686. // 4. If state is "closed" or "errored", return a promise resolved with undefined.
  687. if (state == WritableStream::State::Closed || state == WritableStream::State::Errored)
  688. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  689. // 5. If stream.[[pendingAbortRequest]] is not undefined, return stream.[[pendingAbortRequest]]'s promise.
  690. if (stream.pending_abort_request().has_value())
  691. return stream.pending_abort_request()->promise;
  692. // 6. Assert: state is "writable" or "erroring".
  693. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  694. // 7. Let wasAlreadyErroring be false.
  695. auto was_already_erroring = false;
  696. // 8. If state is "erroring",
  697. if (state == WritableStream::State::Erroring) {
  698. // 1. Set wasAlreadyErroring to true.
  699. was_already_erroring = true;
  700. // 2. Set reason to undefined.
  701. reason = JS::js_undefined();
  702. }
  703. // 9. Let promise be a new promise.
  704. auto promise = WebIDL::create_promise(realm);
  705. // 10. Set stream.[[pendingAbortRequest]] to a new pending abort request whose promise is promise, reason is reason, and was already erroring is wasAlreadyErroring.
  706. stream.set_pending_abort_request(PendingAbortRequest { promise, reason, was_already_erroring });
  707. // 11. If wasAlreadyErroring is false, perform ! WritableStreamStartErroring(stream, reason).
  708. if (!was_already_erroring)
  709. TRY(writable_stream_start_erroring(stream, reason));
  710. // 12. Return promise.
  711. return promise;
  712. }
  713. // https://streams.spec.whatwg.org/#writable-stream-close
  714. WebIDL::ExceptionOr<JS::NonnullGCPtr<WebIDL::Promise>> writable_stream_close(WritableStream& stream)
  715. {
  716. auto& realm = stream.realm();
  717. // 1. Let state be stream.[[state]].
  718. auto state = stream.state();
  719. // 2. If state is "closed" or "errored", return a promise rejected with a TypeError exception.
  720. if (state == WritableStream::State::Closed || state == WritableStream::State::Errored) {
  721. auto message = state == WritableStream::State::Closed ? "Cannot close a closed stream"sv : "Cannot close an errored stream"sv;
  722. auto exception = MUST_OR_THROW_OOM(JS::TypeError::create(realm, message));
  723. return WebIDL::create_rejected_promise(realm, exception);
  724. }
  725. // 3. Assert: state is "writable" or "erroring".
  726. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  727. // 4. Assert: ! WritableStreamCloseQueuedOrInFlight(stream) is false.
  728. VERIFY(!writable_stream_close_queued_or_in_flight(stream));
  729. // 5. Let promise be a new promise.
  730. auto promise = WebIDL::create_promise(realm);
  731. // 6. Set stream.[[closeRequest]] to promise.
  732. stream.set_close_request(promise);
  733. // 7. Let writer be stream.[[writer]].
  734. auto writer = stream.writer();
  735. // 8. If writer is not undefined, and stream.[[backpressure]] is true, and state is "writable", resolve writer.[[readyPromise]] with undefined.
  736. if (writer && stream.backpressure() && state == WritableStream::State::Writable)
  737. WebIDL::resolve_promise(realm, *writer->ready_promise(), JS::js_undefined());
  738. // 9. Perform ! WritableStreamDefaultControllerClose(stream.[[controller]]).
  739. TRY(writable_stream_default_controller_close(*stream.controller()));
  740. // 10. Return promise.
  741. return promise;
  742. }
  743. // https://streams.spec.whatwg.org/#writable-stream-add-write-request
  744. WebIDL::ExceptionOr<JS::NonnullGCPtr<WebIDL::Promise>> writable_stream_add_write_request(WritableStream& stream)
  745. {
  746. auto& realm = stream.realm();
  747. auto& vm = stream.vm();
  748. // 1. Assert: ! IsWritableStreamLocked(stream) is true.
  749. VERIFY(is_writable_stream_locked(stream));
  750. // 2. Assert: stream.[[state]] is "writable".
  751. VERIFY(stream.state() == WritableStream::State::Writable);
  752. // 3. Let promise be a new promise.
  753. auto promise = WebIDL::create_promise(realm);
  754. // 4. Append promise to stream.[[writeRequests]].
  755. TRY_OR_THROW_OOM(vm, stream.write_requests().try_append(promise));
  756. // 5. Return promise.
  757. return promise;
  758. }
  759. // https://streams.spec.whatwg.org/#writable-stream-close-queued-or-in-flight
  760. bool writable_stream_close_queued_or_in_flight(WritableStream const& stream)
  761. {
  762. // 1. If stream.[[closeRequest]] is undefined and stream.[[inFlightCloseRequest]] is undefined, return false.
  763. if (!stream.close_request() && !stream.in_flight_write_request())
  764. return false;
  765. // 2. Return true.
  766. return true;
  767. }
  768. // https://streams.spec.whatwg.org/#writable-stream-deal-with-rejection
  769. WebIDL::ExceptionOr<void> writable_stream_deal_with_rejection(WritableStream& stream, JS::Value error)
  770. {
  771. // 1. Let state be stream.[[state]].
  772. auto state = stream.state();
  773. // 2. If state is "writable",
  774. if (state == WritableStream::State::Writable) {
  775. // 1. Perform ! WritableStreamStartErroring(stream, error).
  776. // 2. Return.
  777. return writable_stream_start_erroring(stream, error);
  778. }
  779. // 3. Assert: state is "erroring".
  780. VERIFY(state == WritableStream::State::Erroring);
  781. // 4. Perform ! WritableStreamFinishErroring(stream).
  782. return writable_stream_finish_erroring(stream);
  783. }
  784. // https://streams.spec.whatwg.org/#writable-stream-finish-erroring
  785. WebIDL::ExceptionOr<void> writable_stream_finish_erroring(WritableStream& stream)
  786. {
  787. auto& realm = stream.realm();
  788. // 1. Assert: stream.[[state]] is "erroring".
  789. VERIFY(stream.state() == WritableStream::State::Erroring);
  790. // 2. Assert: ! WritableStreamHasOperationMarkedInFlight(stream) is false.
  791. VERIFY(!writable_stream_has_operation_marked_in_flight(stream));
  792. // 3. Set stream.[[state]] to "errored".
  793. stream.set_state(WritableStream::State::Errored);
  794. // 4. Perform ! stream.[[controller]].[[ErrorSteps]]().
  795. stream.controller()->error_steps();
  796. // 5. Let storedError be stream.[[storedError]].
  797. auto stored_error = stream.stored_error();
  798. // 6. For each writeRequest of stream.[[writeRequests]]:
  799. for (auto& write_request : stream.write_requests()) {
  800. // 1. Reject writeRequest with storedError.
  801. WebIDL::reject_promise(realm, *write_request, stored_error);
  802. }
  803. // 7. Set stream.[[writeRequests]] to an empty list.
  804. stream.write_requests().clear();
  805. // 8. If stream.[[pendingAbortRequest]] is undefined,
  806. if (!stream.pending_abort_request().has_value()) {
  807. // 1. Perform ! WritableStreamRejectCloseAndClosedPromiseIfNeeded(stream).
  808. writable_stream_reject_close_and_closed_promise_if_needed(stream);
  809. // 2. Return.
  810. return {};
  811. }
  812. // 9. Let abortRequest be stream.[[pendingAbortRequest]].
  813. // 10. Set stream.[[pendingAbortRequest]] to undefined.
  814. auto abort_request = stream.pending_abort_request().release_value();
  815. // 11. If abortRequest’s was already erroring is true,
  816. if (abort_request.was_already_erroring) {
  817. // 1. Reject abortRequest’s promise with storedError.
  818. WebIDL::reject_promise(realm, abort_request.promise, stored_error);
  819. // 2. Perform ! WritableStreamRejectCloseAndClosedPromiseIfNeeded(stream).
  820. writable_stream_reject_close_and_closed_promise_if_needed(stream);
  821. // 3. Return.
  822. return {};
  823. }
  824. // 12. Let promise be ! stream.[[controller]].[[AbortSteps]](abortRequest’s reason).
  825. auto promise = TRY(stream.controller()->abort_steps(abort_request.reason));
  826. // 13. Upon fulfillment of promise,
  827. WebIDL::upon_fulfillment(*promise, [&, abort_promise = abort_request.promise](auto const&) -> WebIDL::ExceptionOr<JS::Value> {
  828. // 1. Resolve abortRequest’s promise with undefined.
  829. WebIDL::resolve_promise(realm, abort_promise, JS::js_undefined());
  830. // 2. Perform ! WritableStreamRejectCloseAndClosedPromiseIfNeeded(stream).
  831. writable_stream_reject_close_and_closed_promise_if_needed(stream);
  832. return JS::js_undefined();
  833. });
  834. // 14. Upon rejection of promise with reason reason,
  835. WebIDL::upon_rejection(*promise, [&, abort_promise = abort_request.promise](auto const& reason) -> WebIDL::ExceptionOr<JS::Value> {
  836. // 1. Reject abortRequest’s promise with reason.
  837. WebIDL::reject_promise(realm, abort_promise, reason);
  838. // 2. Perform ! WritableStreamRejectCloseAndClosedPromiseIfNeeded(stream).
  839. writable_stream_reject_close_and_closed_promise_if_needed(stream);
  840. return JS::js_undefined();
  841. });
  842. return {};
  843. }
  844. // https://streams.spec.whatwg.org/#writable-stream-finish-in-flight-close
  845. void writable_stream_finish_in_flight_close(WritableStream& stream)
  846. {
  847. auto& realm = stream.realm();
  848. // 1. Assert: stream.[[inFlightCloseRequest]] is not undefined.
  849. VERIFY(stream.in_flight_close_request());
  850. // 2. Resolve stream.[[inFlightCloseRequest]] with undefined.
  851. WebIDL::resolve_promise(realm, *stream.in_flight_close_request(), JS::js_undefined());
  852. // 3. Set stream.[[inFlightCloseRequest]] to undefined.
  853. stream.set_in_flight_close_request({});
  854. // 4. Let state be stream.[[state]].
  855. auto state = stream.state();
  856. // 5. Assert: stream.[[state]] is "writable" or "erroring".
  857. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  858. // 6. If state is "erroring",
  859. if (state == WritableStream::State::Erroring) {
  860. // 1. Set stream.[[storedError]] to undefined.
  861. stream.set_stored_error(JS::js_undefined());
  862. // 2. If stream.[[pendingAbortRequest]] is not undefined,
  863. if (stream.pending_abort_request().has_value()) {
  864. // 1. Resolve stream.[[pendingAbortRequest]]'s promise with undefined.
  865. // 2. Set stream.[[pendingAbortRequest]] to undefined.
  866. WebIDL::resolve_promise(realm, stream.pending_abort_request().release_value().promise, JS::js_undefined());
  867. }
  868. }
  869. // 7. Set stream.[[state]] to "closed".
  870. stream.set_state(WritableStream::State::Closed);
  871. // 8. Let writer be stream.[[writer]].
  872. auto writer = stream.writer();
  873. // 9. If writer is not undefined, resolve writer.[[closedPromise]] with undefined.
  874. if (writer)
  875. WebIDL::resolve_promise(realm, *writer->closed_promise(), JS::js_undefined());
  876. // 10. Assert: stream.[[pendingAbortRequest]] is undefined.
  877. VERIFY(!stream.pending_abort_request().has_value());
  878. // 11. Assert: stream.[[storedError]] is undefined.
  879. VERIFY(stream.stored_error().is_undefined());
  880. }
  881. // https://streams.spec.whatwg.org/#writable-stream-finish-in-flight-close-with-error
  882. WebIDL::ExceptionOr<void> writable_stream_finish_in_flight_close_with_error(WritableStream& stream, JS::Value error)
  883. {
  884. auto& realm = stream.realm();
  885. // 1. Assert: stream.[[inFlightCloseRequest]] is not undefined.
  886. VERIFY(stream.in_flight_close_request());
  887. // 2. Reject stream.[[inFlightCloseRequest]] with error.
  888. WebIDL::reject_promise(realm, *stream.in_flight_close_request(), error);
  889. // 3. Set stream.[[inFlightCloseRequest]] to undefined.
  890. stream.set_in_flight_close_request({});
  891. // 4. Assert: stream.[[state]] is "writable" or "erroring".
  892. auto state = stream.state();
  893. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  894. // 5. If stream.[[pendingAbortRequest]] is not undefined,
  895. if (stream.pending_abort_request().has_value()) {
  896. // 1. Reject stream.[[pendingAbortRequest]]'s promise with error.
  897. // 2. Set stream.[[pendingAbortRequest]] to undefined.
  898. WebIDL::reject_promise(realm, stream.pending_abort_request().release_value().promise, error);
  899. }
  900. // 6. Perform ! WritableStreamDealWithRejection(stream, error).
  901. return writable_stream_deal_with_rejection(stream, error);
  902. }
  903. // https://streams.spec.whatwg.org/#writable-stream-finish-in-flight-write
  904. void writable_stream_finish_in_flight_write(WritableStream& stream)
  905. {
  906. auto& realm = stream.realm();
  907. // 1. Assert: stream.[[inFlightWriteRequest]] is not undefined.
  908. VERIFY(stream.in_flight_write_request());
  909. // 2. Resolve stream.[[inFlightWriteRequest]] with undefined.
  910. WebIDL::resolve_promise(realm, *stream.in_flight_write_request(), JS::js_undefined());
  911. // 3. Set stream.[[inFlightWriteRequest]] to undefined.
  912. stream.set_in_flight_write_request({});
  913. }
  914. // https://streams.spec.whatwg.org/#writable-stream-finish-in-flight-write-with-error
  915. WebIDL::ExceptionOr<void> writable_stream_finish_in_flight_write_with_error(WritableStream& stream, JS::Value error)
  916. {
  917. auto& realm = stream.realm();
  918. // 1. Assert: stream.[[inFlightWriteRequest]] is not undefined.
  919. VERIFY(stream.in_flight_write_request());
  920. // 2. Reject stream.[[inFlightWriteRequest]] with error.
  921. WebIDL::reject_promise(realm, *stream.in_flight_write_request(), error);
  922. // 3. Set stream.[[inFlightWriteRequest]] to undefined.
  923. stream.set_in_flight_write_request({});
  924. // 4. Assert: stream.[[state]] is "writable" or "erroring".
  925. auto state = stream.state();
  926. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  927. // 5. Perform ! WritableStreamDealWithRejection(stream, error).
  928. return writable_stream_deal_with_rejection(stream, error);
  929. }
  930. // https://streams.spec.whatwg.org/#writable-stream-has-operation-marked-in-flight
  931. bool writable_stream_has_operation_marked_in_flight(WritableStream const& stream)
  932. {
  933. // 1. If stream.[[inFlightWriteRequest]] is undefined and stream.[[inFlightCloseRequest]] is undefined, return false.
  934. if (!stream.in_flight_write_request() && !stream.in_flight_close_request())
  935. return false;
  936. // 2. Return true.
  937. return true;
  938. }
  939. // https://streams.spec.whatwg.org/#writable-stream-mark-close-request-in-flight
  940. void writable_stream_mark_close_request_in_flight(WritableStream& stream)
  941. {
  942. // 1. Assert: stream.[[inFlightCloseRequest]] is undefined.
  943. VERIFY(!stream.in_flight_close_request());
  944. // 2. Assert: stream.[[closeRequest]] is not undefined.
  945. VERIFY(stream.close_request());
  946. // 3. Set stream.[[inFlightCloseRequest]] to stream.[[closeRequest]].
  947. stream.set_in_flight_close_request(stream.close_request());
  948. // 4. Set stream.[[closeRequest]] to undefined.
  949. stream.set_close_request({});
  950. }
  951. // https://streams.spec.whatwg.org/#writable-stream-mark-first-write-request-in-flight
  952. void writable_stream_mark_first_write_request_in_flight(WritableStream& stream)
  953. {
  954. // 1. Assert: stream.[[inFlightWriteRequest]] is undefined.
  955. VERIFY(!stream.in_flight_write_request());
  956. // 2. Assert: stream.[[writeRequests]] is not empty.
  957. VERIFY(!stream.write_requests().is_empty());
  958. // 3. Let writeRequest be stream.[[writeRequests]][0].
  959. // 4. Remove writeRequest from stream.[[writeRequests]].
  960. auto write_request = stream.write_requests().take_first();
  961. // 5. Set stream.[[inFlightWriteRequest]] to writeRequest.
  962. stream.set_in_flight_write_request(write_request);
  963. }
  964. // https://streams.spec.whatwg.org/#writable-stream-reject-close-and-closed-promise-if-needed
  965. void writable_stream_reject_close_and_closed_promise_if_needed(WritableStream& stream)
  966. {
  967. auto& realm = stream.realm();
  968. // 1. Assert: stream.[[state]] is "errored".
  969. VERIFY(stream.state() == WritableStream::State::Errored);
  970. // 2. If stream.[[closeRequest]] is not undefined,
  971. if (stream.close_request()) {
  972. // 1. Assert: stream.[[inFlightCloseRequest]] is undefined.
  973. VERIFY(!stream.in_flight_close_request());
  974. // 2. Reject stream.[[closeRequest]] with stream.[[storedError]].
  975. WebIDL::reject_promise(realm, *stream.close_request(), stream.stored_error());
  976. // 3. Set stream.[[closeRequest]] to undefined.
  977. stream.set_close_request({});
  978. }
  979. // 3. Let writer be stream.[[writer]].
  980. auto writer = stream.writer();
  981. // 4. If writer is not undefined,
  982. if (writer) {
  983. // 1. Reject writer.[[closedPromise]] with stream.[[storedError]].
  984. WebIDL::reject_promise(realm, *writer->closed_promise(), stream.stored_error());
  985. // 2. Set writer.[[closedPromise]].[[PromiseIsHandled]] to true.
  986. WebIDL::mark_promise_as_handled(*writer->closed_promise());
  987. }
  988. }
  989. // https://streams.spec.whatwg.org/#writable-stream-start-erroring
  990. WebIDL::ExceptionOr<void> writable_stream_start_erroring(WritableStream& stream, JS::Value reason)
  991. {
  992. // 1. Assert: stream.[[storedError]] is undefined.
  993. VERIFY(stream.stored_error().is_undefined());
  994. // 2. Assert: stream.[[state]] is "writable".
  995. VERIFY(stream.state() == WritableStream::State::Writable);
  996. // 3. Let controller be stream.[[controller]].
  997. auto controller = stream.controller();
  998. // 4. Assert: controller is not undefined.
  999. VERIFY(controller);
  1000. // 5. Set stream.[[state]] to "erroring".
  1001. stream.set_state(WritableStream::State::Erroring);
  1002. // 6. Set stream.[[storedError]] to reason.
  1003. stream.set_stored_error(reason);
  1004. // 7. Let writer be stream.[[writer]].
  1005. auto writer = stream.writer();
  1006. // 8. If writer is not undefined, perform ! WritableStreamDefaultWriterEnsureReadyPromiseRejected(writer, reason).
  1007. if (writer)
  1008. writable_stream_default_writer_ensure_ready_promise_rejected(*writer, reason);
  1009. // 9. If ! WritableStreamHasOperationMarkedInFlight(stream) is false and controller.[[started]] is true, perform ! WritableStreamFinishErroring(stream).
  1010. if (!writable_stream_has_operation_marked_in_flight(stream) && controller->started())
  1011. TRY(writable_stream_finish_erroring(stream));
  1012. return {};
  1013. }
  1014. // https://streams.spec.whatwg.org/#writable-stream-update-backpressure
  1015. void writable_stream_update_backpressure(WritableStream& stream, bool backpressure)
  1016. {
  1017. auto& realm = stream.realm();
  1018. // 1. Assert: stream.[[state]] is "writable".
  1019. VERIFY(stream.state() == WritableStream::State::Writable);
  1020. // 2. Assert: ! WritableStreamCloseQueuedOrInFlight(stream) is false.
  1021. VERIFY(!writable_stream_close_queued_or_in_flight(stream));
  1022. // 3. Let writer be stream.[[writer]].
  1023. auto writer = stream.writer();
  1024. // 4. If writer is not undefined and backpressure is not stream.[[backpressure]],
  1025. if (writer && backpressure != stream.backpressure()) {
  1026. // 1. If backpressure is true, set writer.[[readyPromise]] to a new promise.
  1027. if (backpressure) {
  1028. writer->set_ready_promise(WebIDL::create_promise(realm));
  1029. }
  1030. // 2. Otherwise,
  1031. else {
  1032. // 1. Assert: backpressure is false.
  1033. // 2. Resolve writer.[[readyPromise]] with undefined.
  1034. WebIDL::resolve_promise(realm, *writer->ready_promise(), JS::js_undefined());
  1035. }
  1036. }
  1037. // 5. Set stream.[[backpressure]] to backpressure.
  1038. stream.set_backpressure(backpressure);
  1039. }
  1040. // https://streams.spec.whatwg.org/#writable-stream-default-writer-abort
  1041. WebIDL::ExceptionOr<JS::NonnullGCPtr<WebIDL::Promise>> writable_stream_default_writer_abort(WritableStreamDefaultWriter& writer, JS::Value reason)
  1042. {
  1043. // 1. Let stream be writer.[[stream]].
  1044. auto stream = writer.stream();
  1045. // 2. Assert: stream is not undefined.
  1046. VERIFY(stream);
  1047. // 3. Return ! WritableStreamAbort(stream, reason).
  1048. return writable_stream_abort(*stream, reason);
  1049. }
  1050. // https://streams.spec.whatwg.org/#writable-stream-default-writer-close
  1051. WebIDL::ExceptionOr<JS::NonnullGCPtr<WebIDL::Promise>> writable_stream_default_writer_close(WritableStreamDefaultWriter& writer)
  1052. {
  1053. // 1. Let stream be writer.[[stream]].
  1054. auto stream = writer.stream();
  1055. // 2. Assert: stream is not undefined.
  1056. VERIFY(stream);
  1057. // 3. Return ! WritableStreamClose(stream).
  1058. return writable_stream_close(*stream);
  1059. }
  1060. // https://streams.spec.whatwg.org/#writable-stream-default-writer-ensure-closed-promise-rejected
  1061. void writable_stream_default_writer_ensure_closed_promise_rejected(WritableStreamDefaultWriter& writer, JS::Value error)
  1062. {
  1063. auto& realm = writer.realm();
  1064. // 1. If writer.[[closedPromise]].[[PromiseState]] is "pending", reject writer.[[closedPromise]] with error.
  1065. auto& closed_promise = verify_cast<JS::Promise>(*writer.closed_promise()->promise());
  1066. if (closed_promise.state() == JS::Promise::State::Pending) {
  1067. WebIDL::reject_promise(realm, *writer.closed_promise(), error);
  1068. }
  1069. // 2. Otherwise, set writer.[[closedPromise]] to a promise rejected with error.
  1070. else {
  1071. writer.set_closed_promise(WebIDL::create_rejected_promise(realm, error));
  1072. }
  1073. // 3. Set writer.[[closedPromise]].[[PromiseIsHandled]] to true.
  1074. WebIDL::mark_promise_as_handled(*writer.closed_promise());
  1075. }
  1076. // https://streams.spec.whatwg.org/#writable-stream-default-writer-ensure-ready-promise-rejected
  1077. void writable_stream_default_writer_ensure_ready_promise_rejected(WritableStreamDefaultWriter& writer, JS::Value error)
  1078. {
  1079. auto& realm = writer.realm();
  1080. // 1. If writer.[[readyPromise]].[[PromiseState]] is "pending", reject writer.[[readyPromise]] with error.
  1081. auto& ready_promise = verify_cast<JS::Promise>(*writer.ready_promise()->promise());
  1082. if (ready_promise.state() == JS::Promise::State::Pending) {
  1083. WebIDL::reject_promise(realm, *writer.ready_promise(), error);
  1084. }
  1085. // 2. Otherwise, set writer.[[readyPromise]] to a promise rejected with error.
  1086. else {
  1087. writer.set_ready_promise(WebIDL::create_rejected_promise(realm, error));
  1088. }
  1089. // 3. Set writer.[[readyPromise]].[[PromiseIsHandled]] to true.
  1090. WebIDL::mark_promise_as_handled(*writer.ready_promise());
  1091. }
  1092. // https://streams.spec.whatwg.org/#writable-stream-default-writer-get-desired-size
  1093. Optional<double> writable_stream_default_writer_get_desired_size(WritableStreamDefaultWriter const& writer)
  1094. {
  1095. // 1. Let stream be writer.[[stream]].
  1096. auto stream = writer.stream();
  1097. // 2. Let state be stream.[[state]].
  1098. auto state = stream->state();
  1099. // 3. If state is "errored" or "erroring", return null.
  1100. if (state == WritableStream::State::Errored || state == WritableStream::State::Erroring)
  1101. return {};
  1102. // 4. If state is "closed", return 0.
  1103. if (state == WritableStream::State::Closed)
  1104. return 0.0;
  1105. // 5. Return ! WritableStreamDefaultControllerGetDesiredSize(stream.[[controller]]).
  1106. return writable_stream_default_controller_get_desired_size(*stream->controller());
  1107. }
  1108. // https://streams.spec.whatwg.org/#writable-stream-default-writer-release
  1109. WebIDL::ExceptionOr<void> writable_stream_default_writer_release(WritableStreamDefaultWriter& writer)
  1110. {
  1111. auto& realm = writer.realm();
  1112. // 1. Let stream be writer.[[stream]].
  1113. auto stream = writer.stream();
  1114. // 2. Assert: stream is not undefined.
  1115. VERIFY(stream);
  1116. // 3. Assert: stream.[[writer]] is writer.
  1117. VERIFY(stream->writer().ptr() == &writer);
  1118. // 4. Let releasedError be a new TypeError.
  1119. auto released_error = MUST_OR_THROW_OOM(JS::TypeError::create(realm, "Writer's stream lock has been released"sv));
  1120. // 5. Perform ! WritableStreamDefaultWriterEnsureReadyPromiseRejected(writer, releasedError).
  1121. writable_stream_default_writer_ensure_ready_promise_rejected(writer, released_error);
  1122. // 6. Perform ! WritableStreamDefaultWriterEnsureClosedPromiseRejected(writer, releasedError).
  1123. writable_stream_default_writer_ensure_closed_promise_rejected(writer, released_error);
  1124. // 7. Set stream.[[writer]] to undefined.
  1125. stream->set_writer({});
  1126. // 8. Set writer.[[stream]] to undefined.
  1127. writer.set_stream({});
  1128. return {};
  1129. }
  1130. // https://streams.spec.whatwg.org/#writable-stream-default-writer-write
  1131. WebIDL::ExceptionOr<JS::NonnullGCPtr<WebIDL::Promise>> writable_stream_default_writer_write(WritableStreamDefaultWriter& writer, JS::Value chunk)
  1132. {
  1133. auto& realm = writer.realm();
  1134. // 1. Let stream be writer.[[stream]].
  1135. auto stream = writer.stream();
  1136. // 2. Assert: stream is not undefined.
  1137. VERIFY(stream);
  1138. // 3. Let controller be stream.[[controller]].
  1139. auto controller = stream->controller();
  1140. // 4. Let chunkSize be ! WritableStreamDefaultControllerGetChunkSize(controller, chunk).
  1141. auto chunk_size = TRY(writable_stream_default_controller_get_chunk_size(*controller, chunk));
  1142. // 5. If stream is not equal to writer.[[stream]], return a promise rejected with a TypeError exception.
  1143. if (stream.ptr() != writer.stream().ptr()) {
  1144. auto exception = MUST_OR_THROW_OOM(JS::TypeError::create(realm, "Writer's locked stream changed during write"sv));
  1145. return WebIDL::create_rejected_promise(realm, exception);
  1146. }
  1147. // 6. Let state be stream.[[state]].
  1148. auto state = stream->state();
  1149. // 7. If state is "errored", return a promise rejected with stream.[[storedError]].
  1150. if (state == WritableStream::State::Errored)
  1151. return WebIDL::create_rejected_promise(realm, stream->stored_error());
  1152. // 8. If ! WritableStreamCloseQueuedOrInFlight(stream) is true or state is "closed", return a promise rejected with a TypeError exception indicating that the stream is closing or closed.
  1153. if (writable_stream_close_queued_or_in_flight(*stream) || state == WritableStream::State::Closed) {
  1154. auto exception = MUST_OR_THROW_OOM(JS::TypeError::create(realm, "Cannot write to a writer whose stream is closing or already closed"sv));
  1155. return WebIDL::create_rejected_promise(realm, exception);
  1156. }
  1157. // 9. If state is "erroring", return a promise rejected with stream.[[storedError]].
  1158. if (state == WritableStream::State::Erroring)
  1159. return WebIDL::create_rejected_promise(realm, stream->stored_error());
  1160. // 10. Assert: state is "writable".
  1161. VERIFY(state == WritableStream::State::Writable);
  1162. // 11. Let promise be ! WritableStreamAddWriteRequest(stream).
  1163. auto promise = writable_stream_add_write_request(*stream);
  1164. // 12. Perform ! WritableStreamDefaultControllerWrite(controller, chunk, chunkSize).
  1165. TRY(writable_stream_default_controller_write(*controller, chunk, chunk_size));
  1166. // 13. Return promise.
  1167. return promise;
  1168. }
  1169. // https://streams.spec.whatwg.org/#set-up-writable-stream-default-controller
  1170. WebIDL::ExceptionOr<void> set_up_writable_stream_default_controller(WritableStream& stream, WritableStreamDefaultController& controller, StartAlgorithm&& start_algorithm, WriteAlgorithm&& write_algorithm, CloseAlgorithm&& close_algorithm, AbortAlgorithm&& abort_algorithm, double high_water_mark, SizeAlgorithm&& size_algorithm)
  1171. {
  1172. auto& realm = stream.realm();
  1173. // 1. Assert: stream implements WritableStream.
  1174. // 2. Assert: stream.[[controller]] is undefined.
  1175. VERIFY(!stream.controller());
  1176. // 3. Set controller.[[stream]] to stream.
  1177. controller.set_stream(stream);
  1178. // 4. Set stream.[[controller]] to controller.
  1179. stream.set_controller(controller);
  1180. // 5. Perform ! ResetQueue(controller).
  1181. reset_queue(controller);
  1182. // 6. Set controller.[[signal]] to a new AbortSignal.
  1183. controller.set_signal(MUST_OR_THROW_OOM(realm.heap().allocate<DOM::AbortSignal>(realm, realm)));
  1184. // 7. Set controller.[[started]] to false.
  1185. controller.set_started(false);
  1186. // 8. Set controller.[[strategySizeAlgorithm]] to sizeAlgorithm.
  1187. controller.set_strategy_size_algorithm(move(size_algorithm));
  1188. // 9. Set controller.[[strategyHWM]] to highWaterMark.
  1189. controller.set_strategy_hwm(high_water_mark);
  1190. // 10. Set controller.[[writeAlgorithm]] to writeAlgorithm.
  1191. controller.set_write_algorithm(move(write_algorithm));
  1192. // 11. Set controller.[[closeAlgorithm]] to closeAlgorithm.
  1193. controller.set_close_algorithm(move(close_algorithm));
  1194. // 12. Set controller.[[abortAlgorithm]] to abortAlgorithm.
  1195. controller.set_abort_algorithm(move(abort_algorithm));
  1196. // 13. Let backpressure be ! WritableStreamDefaultControllerGetBackpressure(controller).
  1197. auto backpressure = writable_stream_default_controller_get_backpressure(controller);
  1198. // 14. Perform ! WritableStreamUpdateBackpressure(stream, backpressure).
  1199. writable_stream_update_backpressure(stream, backpressure);
  1200. // 15. Let startResult be the result of performing startAlgorithm. (This may throw an exception.)
  1201. auto start_result = TRY(start_algorithm());
  1202. // 16. Let startPromise be a promise resolved with startResult.
  1203. auto start_promise = WebIDL::create_resolved_promise(realm, start_result ? start_result->promise() : JS::js_undefined());
  1204. // 17. Upon fulfillment of startPromise,
  1205. WebIDL::upon_fulfillment(*start_promise, [&](auto const&) -> WebIDL::ExceptionOr<JS::Value> {
  1206. // 1. Assert: stream.[[state]] is "writable" or "erroring".
  1207. auto state = stream.state();
  1208. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  1209. // 2. Set controller.[[started]] to true.
  1210. controller.set_started(true);
  1211. // 3. Perform ! WritableStreamDefaultControllerAdvanceQueueIfNeeded(controller).
  1212. TRY(writable_stream_default_controller_advance_queue_if_needed(controller));
  1213. return JS::js_undefined();
  1214. });
  1215. // 18. Upon rejection of startPromise with reason r,
  1216. WebIDL::upon_rejection(*start_promise, [&](JS::Value reason) -> WebIDL::ExceptionOr<JS::Value> {
  1217. // 1. Assert: stream.[[state]] is "writable" or "erroring".
  1218. auto state = stream.state();
  1219. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  1220. // 2. Set controller.[[started]] to true.
  1221. controller.set_started(true);
  1222. // 3. Perform ! WritableStreamDealWithRejection(stream, r).
  1223. TRY(writable_stream_deal_with_rejection(stream, reason));
  1224. return JS::js_undefined();
  1225. });
  1226. return {};
  1227. }
  1228. // https://streams.spec.whatwg.org/#set-up-writable-stream-default-controller-from-underlying-sink
  1229. WebIDL::ExceptionOr<void> set_up_writable_stream_default_controller_from_underlying_sink(WritableStream& stream, JS::Value underlying_sink_value, UnderlyingSink& underlying_sink, double high_water_mark, SizeAlgorithm&& size_algorithm)
  1230. {
  1231. auto& realm = stream.realm();
  1232. // 1. Let controller be a new WritableStreamDefaultController.
  1233. auto controller = MUST_OR_THROW_OOM(realm.heap().allocate<WritableStreamDefaultController>(realm, realm));
  1234. // 2. Let startAlgorithm be an algorithm that returns undefined.
  1235. StartAlgorithm start_algorithm = [] { return JS::GCPtr<WebIDL::Promise> {}; };
  1236. // 3. Let writeAlgorithm be an algorithm that returns a promise resolved with undefined.
  1237. WriteAlgorithm write_algorithm = [&realm](auto const&) {
  1238. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  1239. };
  1240. // 4. Let closeAlgorithm be an algorithm that returns a promise resolved with undefined.
  1241. CloseAlgorithm close_algorithm = [&realm] {
  1242. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  1243. };
  1244. // 5. Let abortAlgorithm be an algorithm that returns a promise resolved with undefined.
  1245. AbortAlgorithm abort_algorithm = [&realm](auto const&) {
  1246. return WebIDL::create_resolved_promise(realm, JS::js_undefined());
  1247. };
  1248. // 6. If underlyingSinkDict["start"] exists, then set startAlgorithm to an algorithm which returns the result of invoking underlyingSinkDict["start"] with argument list « controller » and callback this value underlyingSink.
  1249. if (underlying_sink.start) {
  1250. start_algorithm = [&, callback = underlying_sink.start]() -> WebIDL::ExceptionOr<JS::GCPtr<WebIDL::Promise>> {
  1251. auto result = TRY(WebIDL::invoke_callback(*callback, underlying_sink_value, controller)).release_value();
  1252. return WebIDL::create_resolved_promise(realm, result);
  1253. };
  1254. }
  1255. // 7. If underlyingSinkDict["write"] exists, then set writeAlgorithm to an algorithm which takes an argument chunk and returns the result of invoking underlyingSinkDict["write"] with argument list « chunk, controller » and callback this value underlyingSink.
  1256. if (underlying_sink.write) {
  1257. write_algorithm = [&, callback = underlying_sink.write](JS::Value chunk) -> WebIDL::ExceptionOr<JS::GCPtr<WebIDL::Promise>> {
  1258. auto result = TRY(WebIDL::invoke_callback(*callback, underlying_sink_value, chunk, controller)).release_value();
  1259. return WebIDL::create_resolved_promise(realm, result);
  1260. };
  1261. }
  1262. // 8. If underlyingSinkDict["close"] exists, then set closeAlgorithm to an algorithm which returns the result of invoking underlyingSinkDict["close"] with argument list «» and callback this value underlyingSink.
  1263. if (underlying_sink.close) {
  1264. close_algorithm = [&, callback = underlying_sink.close]() -> WebIDL::ExceptionOr<JS::GCPtr<WebIDL::Promise>> {
  1265. auto result = TRY(WebIDL::invoke_callback(*callback, underlying_sink_value)).release_value();
  1266. return WebIDL::create_resolved_promise(realm, result);
  1267. };
  1268. }
  1269. // 9. If underlyingSinkDict["abort"] exists, then set abortAlgorithm to an algorithm which takes an argument reason and returns the result of invoking underlyingSinkDict["abort"] with argument list « reason » and callback this value underlyingSink.
  1270. if (underlying_sink.abort) {
  1271. abort_algorithm = [&, callback = underlying_sink.abort](JS::Value reason) -> WebIDL::ExceptionOr<JS::GCPtr<WebIDL::Promise>> {
  1272. auto result = TRY(WebIDL::invoke_callback(*callback, underlying_sink_value, reason)).release_value();
  1273. return WebIDL::create_resolved_promise(realm, result);
  1274. };
  1275. }
  1276. // 10. Perform ? SetUpWritableStreamDefaultController(stream, controller, startAlgorithm, writeAlgorithm, closeAlgorithm, abortAlgorithm, highWaterMark, sizeAlgorithm).
  1277. TRY(set_up_writable_stream_default_controller(stream, controller, move(start_algorithm), move(write_algorithm), move(close_algorithm), move(abort_algorithm), high_water_mark, move(size_algorithm)));
  1278. return {};
  1279. }
  1280. // https://streams.spec.whatwg.org/#writable-stream-default-controller-advance-queue-if-needed
  1281. WebIDL::ExceptionOr<void> writable_stream_default_controller_advance_queue_if_needed(WritableStreamDefaultController& controller)
  1282. {
  1283. // 1. Let stream be controller.[[stream]].
  1284. auto stream = controller.stream();
  1285. // 2. If controller.[[started]] is false, return.
  1286. if (!controller.started())
  1287. return {};
  1288. // 3. If stream.[[inFlightWriteRequest]] is not undefined, return.
  1289. if (stream->in_flight_write_request())
  1290. return {};
  1291. // 4. Let state be stream.[[state]].
  1292. auto state = stream->state();
  1293. // 5. Assert: state is not "closed" or "errored".
  1294. VERIFY(state != WritableStream::State::Closed && state != WritableStream::State::Errored);
  1295. // 6. If state is "erroring",
  1296. if (state == WritableStream::State::Erroring) {
  1297. // 1. Perform ! WritableStreamFinishErroring(stream).
  1298. // 2. Return.
  1299. return writable_stream_finish_erroring(*stream);
  1300. }
  1301. // 7. If controller.[[queue]] is empty, return.
  1302. if (controller.queue().is_empty())
  1303. return {};
  1304. // 8. Let value be ! PeekQueueValue(controller).
  1305. auto value = peek_queue_value(controller);
  1306. // 9. If value is the close sentinel, perform ! WritableStreamDefaultControllerProcessClose(controller).
  1307. if (is_close_sentinel(value)) {
  1308. TRY(writable_stream_default_controller_process_close(controller));
  1309. }
  1310. // 10. Otherwise, perform ! WritableStreamDefaultControllerProcessWrite(controller, value).
  1311. else {
  1312. TRY(writable_stream_default_controller_process_write(controller, value));
  1313. }
  1314. return {};
  1315. }
  1316. // https://streams.spec.whatwg.org/#writable-stream-default-controller-clear-algorithms
  1317. void writable_stream_default_controller_clear_algorithms(WritableStreamDefaultController& controller)
  1318. {
  1319. // 1. Set controller.[[writeAlgorithm]] to undefined.
  1320. controller.set_write_algorithm({});
  1321. // 2. Set controller.[[closeAlgorithm]] to undefined.
  1322. controller.set_close_algorithm({});
  1323. // 3. Set controller.[[abortAlgorithm]] to undefined.
  1324. controller.set_abort_algorithm({});
  1325. // 4. Set controller.[[strategySizeAlgorithm]] to undefined.
  1326. controller.set_strategy_size_algorithm({});
  1327. }
  1328. // https://streams.spec.whatwg.org/#writable-stream-default-controller-close
  1329. WebIDL::ExceptionOr<void> writable_stream_default_controller_close(WritableStreamDefaultController& controller)
  1330. {
  1331. // 1. Perform ! EnqueueValueWithSize(controller, close sentinel, 0).
  1332. TRY(enqueue_value_with_size(controller, create_close_sentinel(), JS::Value(0.0)));
  1333. // 2. Perform ! WritableStreamDefaultControllerAdvanceQueueIfNeeded(controller).
  1334. TRY(writable_stream_default_controller_advance_queue_if_needed(controller));
  1335. return {};
  1336. }
  1337. // https://streams.spec.whatwg.org/#writable-stream-default-controller-error
  1338. WebIDL::ExceptionOr<void> writable_stream_default_controller_error(WritableStreamDefaultController& controller, JS::Value error)
  1339. {
  1340. // 1. Let stream be controller.[[stream]].
  1341. auto stream = controller.stream();
  1342. // 2. Assert: stream.[[state]] is "writable".
  1343. VERIFY(stream->state() == WritableStream::State::Writable);
  1344. // 3. Perform ! WritableStreamDefaultControllerClearAlgorithms(controller).
  1345. writable_stream_default_controller_clear_algorithms(controller);
  1346. // 4. Perform ! WritableStreamStartErroring(stream, error).
  1347. return writable_stream_start_erroring(stream, error);
  1348. }
  1349. // https://streams.spec.whatwg.org/#writable-stream-default-controller-error-if-needed
  1350. WebIDL::ExceptionOr<void> writable_stream_default_controller_error_if_needed(WritableStreamDefaultController& controller, JS::Value error)
  1351. {
  1352. // 1. If controller.[[stream]].[[state]] is "writable", perform ! WritableStreamDefaultControllerError(controller, error).
  1353. if (controller.stream()->state() == WritableStream::State::Writable)
  1354. TRY(writable_stream_default_controller_error(controller, error));
  1355. return {};
  1356. }
  1357. // https://streams.spec.whatwg.org/#writable-stream-default-controller-get-backpressure
  1358. bool writable_stream_default_controller_get_backpressure(WritableStreamDefaultController const& controller)
  1359. {
  1360. // 1. Let desiredSize be ! WritableStreamDefaultControllerGetDesiredSize(controller).
  1361. auto desired_size = writable_stream_default_controller_get_desired_size(controller);
  1362. // 2. Return true if desiredSize ≤ 0, or false otherwise.
  1363. return desired_size <= 0.0;
  1364. }
  1365. // https://streams.spec.whatwg.org/#writable-stream-default-controller-get-chunk-size
  1366. WebIDL::ExceptionOr<JS::Value> writable_stream_default_controller_get_chunk_size(WritableStreamDefaultController& controller, JS::Value chunk)
  1367. {
  1368. // 1. Let returnValue be the result of performing controller.[[strategySizeAlgorithm]], passing in chunk, and interpreting the result as a completion record.
  1369. auto return_value = (*controller.strategy_size_algorithm())(chunk);
  1370. // 2. If returnValue is an abrupt completion,
  1371. if (return_value.is_abrupt()) {
  1372. // 1. Perform ! WritableStreamDefaultControllerErrorIfNeeded(controller, returnValue.[[Value]]).
  1373. TRY(writable_stream_default_controller_error_if_needed(controller, *return_value.release_value()));
  1374. // 2. Return 1.
  1375. return 1.0;
  1376. }
  1377. // 3. Return returnValue.[[Value]].
  1378. return *return_value.release_value();
  1379. }
  1380. // https://streams.spec.whatwg.org/#writable-stream-default-controller-get-desired-size
  1381. double writable_stream_default_controller_get_desired_size(WritableStreamDefaultController const& controller)
  1382. {
  1383. // 1. Return controller.[[strategyHWM]] − controller.[[queueTotalSize]].
  1384. return controller.strategy_hwm() - controller.queue_total_size();
  1385. }
  1386. // https://streams.spec.whatwg.org/#writable-stream-default-controller-process-close
  1387. WebIDL::ExceptionOr<void> writable_stream_default_controller_process_close(WritableStreamDefaultController& controller)
  1388. {
  1389. // 1. Let stream be controller.[[stream]].
  1390. auto stream = controller.stream();
  1391. // 2. Perform ! WritableStreamMarkCloseRequestInFlight(stream).
  1392. writable_stream_mark_close_request_in_flight(*stream);
  1393. // 3. Perform ! DequeueValue(controller).
  1394. dequeue_value(controller);
  1395. // 4. Assert: controller.[[queue]] is empty.
  1396. VERIFY(controller.queue().is_empty());
  1397. // 5. Let sinkClosePromise be the result of performing controller.[[closeAlgorithm]].
  1398. auto sink_close_promise = TRY((*controller.close_algorithm())());
  1399. // 6. Perform ! WritableStreamDefaultControllerClearAlgorithms(controller).
  1400. writable_stream_default_controller_clear_algorithms(controller);
  1401. // 7. Upon fulfillment of sinkClosePromise,
  1402. WebIDL::upon_fulfillment(*sink_close_promise, [&, stream = stream](auto const&) -> WebIDL::ExceptionOr<JS::Value> {
  1403. // 1. Perform ! WritableStreamFinishInFlightClose(stream).
  1404. writable_stream_finish_in_flight_close(*stream);
  1405. return JS::js_undefined();
  1406. });
  1407. // 8. Upon rejection of sinkClosePromise with reason reason,
  1408. WebIDL::upon_rejection(*sink_close_promise, [&, stream = stream](auto const& reason) -> WebIDL::ExceptionOr<JS::Value> {
  1409. // 1. Perform ! WritableStreamFinishInFlightCloseWithError(stream, reason).
  1410. TRY(writable_stream_finish_in_flight_close_with_error(*stream, reason));
  1411. return JS::js_undefined();
  1412. });
  1413. return {};
  1414. }
  1415. // https://streams.spec.whatwg.org/#writable-stream-default-controller-process-write
  1416. WebIDL::ExceptionOr<void> writable_stream_default_controller_process_write(WritableStreamDefaultController& controller, JS::Value chunk)
  1417. {
  1418. // 1. Let stream be controller.[[stream]].
  1419. auto stream = controller.stream();
  1420. // 2. Perform ! WritableStreamMarkFirstWriteRequestInFlight(stream).
  1421. writable_stream_mark_first_write_request_in_flight(*stream);
  1422. // 3. Let sinkWritePromise be the result of performing controller.[[writeAlgorithm]], passing in chunk.
  1423. auto sink_write_promise = TRY((*controller.write_algorithm())(chunk));
  1424. // 4. Upon fulfillment of sinkWritePromise,
  1425. WebIDL::upon_fulfillment(*sink_write_promise, [&, stream = stream](auto const&) -> WebIDL::ExceptionOr<JS::Value> {
  1426. // 1. Perform ! WritableStreamFinishInFlightWrite(stream).
  1427. writable_stream_finish_in_flight_write(*stream);
  1428. // 2. Let state be stream.[[state]].
  1429. auto state = stream->state();
  1430. // 3. Assert: state is "writable" or "erroring".
  1431. VERIFY(state == WritableStream::State::Writable || state == WritableStream::State::Erroring);
  1432. // 4. Perform ! DequeueValue(controller).
  1433. dequeue_value(controller);
  1434. // 5. If ! WritableStreamCloseQueuedOrInFlight(stream) is false and state is "writable",
  1435. if (!writable_stream_close_queued_or_in_flight(*stream) && state == WritableStream::State::Writable) {
  1436. // 1. Let backpressure be ! WritableStreamDefaultControllerGetBackpressure(controller).
  1437. auto backpressure = writable_stream_default_controller_get_backpressure(controller);
  1438. // 2. Perform ! WritableStreamUpdateBackpressure(stream, backpressure).
  1439. writable_stream_update_backpressure(*stream, backpressure);
  1440. }
  1441. // 6 .Perform ! WritableStreamDefaultControllerAdvanceQueueIfNeeded(controller).
  1442. TRY(writable_stream_default_controller_advance_queue_if_needed(controller));
  1443. return JS::js_undefined();
  1444. });
  1445. // 5. Upon rejection of sinkWritePromise with reason,
  1446. WebIDL::upon_rejection(*sink_write_promise, [&, stream = stream](auto const& reason) -> WebIDL::ExceptionOr<JS::Value> {
  1447. // 1. If stream.[[state]] is "writable", perform ! WritableStreamDefaultControllerClearAlgorithms(controller).
  1448. if (stream->state() == WritableStream::State::Writable)
  1449. writable_stream_default_controller_clear_algorithms(controller);
  1450. // 2. Perform ! WritableStreamFinishInFlightWriteWithError(stream, reason).
  1451. TRY(writable_stream_finish_in_flight_write_with_error(*stream, reason));
  1452. return JS::js_undefined();
  1453. });
  1454. return {};
  1455. }
  1456. // https://streams.spec.whatwg.org/#writable-stream-default-controller-write
  1457. WebIDL::ExceptionOr<void> writable_stream_default_controller_write(WritableStreamDefaultController& controller, JS::Value chunk, JS::Value chunk_size)
  1458. {
  1459. auto& vm = controller.vm();
  1460. // 1. Let enqueueResult be EnqueueValueWithSize(controller, chunk, chunkSize).
  1461. auto enqueue_result = enqueue_value_with_size(controller, chunk, chunk_size);
  1462. // 2. If enqueueResult is an abrupt completion,
  1463. if (enqueue_result.is_exception()) {
  1464. auto throw_completion = Bindings::throw_dom_exception_if_needed(vm, [&] { return enqueue_result; }).throw_completion();
  1465. // 1. Perform ! WritableStreamDefaultControllerErrorIfNeeded(controller, enqueueResult.[[Value]]).
  1466. TRY(writable_stream_default_controller_error_if_needed(controller, *throw_completion.release_value()));
  1467. // 2. Return.
  1468. return {};
  1469. }
  1470. // 3. Let stream be controller.[[stream]].
  1471. auto stream = controller.stream();
  1472. // 4. If ! WritableStreamCloseQueuedOrInFlight(stream) is false and stream.[[state]] is "writable",
  1473. if (!writable_stream_close_queued_or_in_flight(*stream) && stream->state() == WritableStream::State::Writable) {
  1474. // 1. Let backpressure be ! WritableStreamDefaultControllerGetBackpressure(controller).
  1475. auto backpressure = writable_stream_default_controller_get_backpressure(controller);
  1476. // 2. Perform ! WritableStreamUpdateBackpressure(stream, backpressure).
  1477. writable_stream_update_backpressure(*stream, backpressure);
  1478. }
  1479. // 5. Perform ! WritableStreamDefaultControllerAdvanceQueueIfNeeded(controller).
  1480. TRY(writable_stream_default_controller_advance_queue_if_needed(controller));
  1481. return {};
  1482. }
  1483. // https://streams.spec.whatwg.org/#is-non-negative-number
  1484. bool is_non_negative_number(JS::Value value)
  1485. {
  1486. // 1. If Type(v) is not Number, return false.
  1487. if (!value.is_number())
  1488. return false;
  1489. // 2. If v is NaN, return false.
  1490. if (value.is_nan())
  1491. return false;
  1492. // 3. If v < 0, return false.
  1493. if (value.as_double() < 0.0)
  1494. return false;
  1495. // 4. Return true.
  1496. return true;
  1497. }
  1498. // https://streams.spec.whatwg.org/#close-sentinel
  1499. // Non-standard function that implements the "close sentinel" value.
  1500. JS::Value create_close_sentinel()
  1501. {
  1502. // The close sentinel is a unique value enqueued into [[queue]], in lieu of a chunk, to signal that the stream is closed. It is only used internally, and is never exposed to web developers.
  1503. // Note: We use the empty Value to signal this as, similarly to the note above, the empty value is not exposed to nor creatable by web developers.
  1504. return {};
  1505. }
  1506. // https://streams.spec.whatwg.org/#close-sentinel
  1507. // Non-standard function that implements the "If value is a close sentinel" check.
  1508. bool is_close_sentinel(JS::Value value)
  1509. {
  1510. return value.is_empty();
  1511. }
  1512. // Non-standard function to aid in converting a user-provided function into a WebIDL::Callback. This is essentially
  1513. // what the Bindings generator would do at compile time, but at runtime instead.
  1514. JS::ThrowCompletionOr<JS::Handle<WebIDL::CallbackType>> property_to_callback(JS::VM& vm, JS::Value value, JS::PropertyKey const& property_key)
  1515. {
  1516. auto property = TRY(value.get(vm, property_key));
  1517. if (property.is_undefined())
  1518. return JS::Handle<WebIDL::CallbackType> {};
  1519. if (!property.is_function())
  1520. return vm.throw_completion<JS::TypeError>(JS::ErrorType::NotAFunction, TRY_OR_THROW_OOM(vm, property.to_string_without_side_effects()));
  1521. return vm.heap().allocate_without_realm<WebIDL::CallbackType>(property.as_object(), HTML::incumbent_settings_object());
  1522. }
  1523. }