AbstractOperations.cpp 81 KB

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