Parser.cpp 202 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687
  1. /*
  2. * Copyright (c) 2020, Stephan Unverwerth <s.unverwerth@serenityos.org>
  3. * Copyright (c) 2020-2022, Linus Groh <linusg@serenityos.org>
  4. * Copyright (c) 2021-2022, David Tuin <davidot@serenityos.org>
  5. * Copyright (c) 2021, Ali Mohammad Pur <mpfard@serenityos.org>
  6. * Copyright (c) 2021, Idan Horowitz <idan.horowitz@serenityos.org>
  7. *
  8. * SPDX-License-Identifier: BSD-2-Clause
  9. */
  10. #include "Parser.h"
  11. #include <AK/Array.h>
  12. #include <AK/CharacterTypes.h>
  13. #include <AK/HashTable.h>
  14. #include <AK/ScopeGuard.h>
  15. #include <AK/StdLibExtras.h>
  16. #include <AK/TemporaryChange.h>
  17. #include <LibJS/Runtime/RegExpObject.h>
  18. #include <LibRegex/Regex.h>
  19. namespace JS {
  20. class ScopePusher {
  21. // NOTE: We really only need ModuleTopLevel and NotModuleTopLevel as the only
  22. // difference seems to be in https://tc39.es/ecma262/#sec-static-semantics-varscopeddeclarations
  23. // where ModuleItemList only does the VarScopedDeclaration and not the
  24. // TopLevelVarScopedDeclarations.
  25. enum class ScopeLevel {
  26. NotTopLevel,
  27. ScriptTopLevel,
  28. ModuleTopLevel,
  29. FunctionTopLevel,
  30. StaticInitTopLevel
  31. };
  32. private:
  33. ScopePusher(Parser& parser, ScopeNode* node, ScopeLevel scope_level)
  34. : m_parser(parser)
  35. , m_scope_level(scope_level)
  36. {
  37. m_parent_scope = exchange(m_parser.m_state.current_scope_pusher, this);
  38. VERIFY(node || (m_parent_scope && scope_level == ScopeLevel::NotTopLevel));
  39. if (!node)
  40. m_node = m_parent_scope->m_node;
  41. else
  42. m_node = node;
  43. VERIFY(m_node);
  44. if (!is_top_level())
  45. m_top_level_scope = m_parent_scope->m_top_level_scope;
  46. else
  47. m_top_level_scope = this;
  48. }
  49. bool is_top_level()
  50. {
  51. return m_scope_level != ScopeLevel::NotTopLevel;
  52. }
  53. public:
  54. static ScopePusher function_scope(Parser& parser, FunctionBody& function_body, Vector<FunctionDeclaration::Parameter> const& parameters)
  55. {
  56. ScopePusher scope_pusher(parser, &function_body, ScopeLevel::FunctionTopLevel);
  57. scope_pusher.m_function_parameters = parameters;
  58. for (auto& parameter : parameters) {
  59. parameter.binding.visit(
  60. [&](FlyString const& name) {
  61. scope_pusher.m_forbidden_lexical_names.set(name);
  62. },
  63. [&](NonnullRefPtr<BindingPattern> const& binding_pattern) {
  64. binding_pattern->for_each_bound_name([&](auto const& name) {
  65. scope_pusher.m_forbidden_lexical_names.set(name);
  66. });
  67. });
  68. }
  69. return scope_pusher;
  70. }
  71. static ScopePusher program_scope(Parser& parser, Program& program)
  72. {
  73. return ScopePusher(parser, &program, program.type() == Program::Type::Script ? ScopeLevel::ScriptTopLevel : ScopeLevel::ModuleTopLevel);
  74. }
  75. static ScopePusher block_scope(Parser& parser, ScopeNode& node)
  76. {
  77. return ScopePusher(parser, &node, ScopeLevel::NotTopLevel);
  78. }
  79. static ScopePusher for_loop_scope(Parser& parser, RefPtr<ASTNode> const& init)
  80. {
  81. ScopePusher scope_pusher(parser, nullptr, ScopeLevel::NotTopLevel);
  82. if (init && is<VariableDeclaration>(*init)) {
  83. auto& variable_declaration = static_cast<VariableDeclaration const&>(*init);
  84. if (variable_declaration.declaration_kind() != DeclarationKind::Var) {
  85. variable_declaration.for_each_bound_name([&](auto const& name) {
  86. scope_pusher.m_forbidden_var_names.set(name);
  87. });
  88. }
  89. }
  90. return scope_pusher;
  91. }
  92. static ScopePusher catch_scope(Parser& parser, RefPtr<BindingPattern> const& pattern, FlyString const& parameter)
  93. {
  94. ScopePusher scope_pusher(parser, nullptr, ScopeLevel::NotTopLevel);
  95. if (pattern) {
  96. pattern->for_each_bound_name([&](auto const& name) {
  97. scope_pusher.m_forbidden_var_names.set(name);
  98. });
  99. } else if (!parameter.is_empty()) {
  100. scope_pusher.m_var_names.set(parameter);
  101. }
  102. return scope_pusher;
  103. }
  104. static ScopePusher static_init_block_scope(Parser& parser, ScopeNode& node)
  105. {
  106. return ScopePusher(parser, &node, ScopeLevel::StaticInitTopLevel);
  107. }
  108. static ScopePusher class_field_scope(Parser& parser)
  109. {
  110. return ScopePusher(parser, nullptr, ScopeLevel::NotTopLevel);
  111. }
  112. void add_declaration(NonnullRefPtr<Declaration> declaration)
  113. {
  114. if (declaration->is_lexical_declaration()) {
  115. declaration->for_each_bound_name([&](auto const& name) {
  116. if (m_var_names.contains(name) || m_forbidden_lexical_names.contains(name) || m_function_names.contains(name))
  117. throw_identifier_declared(name, declaration);
  118. if (m_lexical_names.set(name) != AK::HashSetResult::InsertedNewEntry)
  119. throw_identifier_declared(name, declaration);
  120. });
  121. m_node->add_lexical_declaration(move(declaration));
  122. } else if (!declaration->is_function_declaration()) {
  123. declaration->for_each_bound_name([&](auto const& name) {
  124. ScopePusher* pusher = this;
  125. while (true) {
  126. if (pusher->m_lexical_names.contains(name)
  127. || pusher->m_function_names.contains(name)
  128. || pusher->m_forbidden_var_names.contains(name))
  129. throw_identifier_declared(name, declaration);
  130. pusher->m_var_names.set(name);
  131. if (pusher->is_top_level())
  132. break;
  133. VERIFY(pusher->m_parent_scope != nullptr);
  134. pusher = pusher->m_parent_scope;
  135. }
  136. VERIFY(pusher->is_top_level() && pusher->m_node);
  137. pusher->m_node->add_var_scoped_declaration(declaration);
  138. });
  139. VERIFY(m_top_level_scope);
  140. m_top_level_scope->m_node->add_var_scoped_declaration(move(declaration));
  141. } else {
  142. if (m_scope_level != ScopeLevel::NotTopLevel && m_scope_level != ScopeLevel::ModuleTopLevel) {
  143. // Only non-top levels and Module don't var declare the top functions
  144. declaration->for_each_bound_name([&](auto const& name) {
  145. m_var_names.set(name);
  146. });
  147. m_node->add_var_scoped_declaration(move(declaration));
  148. } else {
  149. VERIFY(is<FunctionDeclaration>(*declaration));
  150. auto& function_declaration = static_cast<FunctionDeclaration const&>(*declaration);
  151. auto& function_name = function_declaration.name();
  152. if (m_var_names.contains(function_name) || m_lexical_names.contains(function_name))
  153. throw_identifier_declared(function_name, declaration);
  154. if (function_declaration.kind() != FunctionKind::Normal || m_parser.m_state.strict_mode) {
  155. if (m_function_names.contains(function_name))
  156. throw_identifier_declared(function_name, declaration);
  157. m_lexical_names.set(function_name);
  158. m_node->add_lexical_declaration(move(declaration));
  159. return;
  160. }
  161. m_function_names.set(function_name);
  162. if (!m_lexical_names.contains(function_name))
  163. m_functions_to_hoist.append(static_ptr_cast<FunctionDeclaration>(declaration));
  164. m_node->add_lexical_declaration(move(declaration));
  165. }
  166. }
  167. }
  168. ScopePusher const* last_function_scope() const
  169. {
  170. for (auto scope_ptr = this; scope_ptr; scope_ptr = scope_ptr->m_parent_scope) {
  171. if (scope_ptr->m_function_parameters.has_value())
  172. return scope_ptr;
  173. }
  174. return nullptr;
  175. }
  176. Vector<FunctionDeclaration::Parameter> const& function_parameters() const
  177. {
  178. return *m_function_parameters;
  179. }
  180. ScopePusher* parent_scope() { return m_parent_scope; }
  181. ScopePusher const* parent_scope() const { return m_parent_scope; }
  182. [[nodiscard]] bool has_declaration(FlyString const& name) const
  183. {
  184. return m_lexical_names.contains(name) || m_var_names.contains(name) || !m_functions_to_hoist.find_if([&name](auto& function) { return function->name() == name; }).is_end();
  185. }
  186. bool contains_direct_call_to_eval() const { return m_contains_direct_call_to_eval; }
  187. bool contains_access_to_arguments_object() const { return m_contains_access_to_arguments_object; }
  188. void set_contains_direct_call_to_eval() { m_contains_direct_call_to_eval = true; }
  189. void set_contains_access_to_arguments_object() { m_contains_access_to_arguments_object = true; }
  190. ~ScopePusher()
  191. {
  192. VERIFY(is_top_level() || m_parent_scope);
  193. if (!m_contains_access_to_arguments_object) {
  194. for (auto& it : m_identifier_and_argument_index_associations) {
  195. for (auto& identifier : it.value) {
  196. if (!has_declaration(identifier.string()))
  197. identifier.set_lexically_bound_function_argument_index(it.key);
  198. }
  199. }
  200. }
  201. for (size_t i = 0; i < m_functions_to_hoist.size(); i++) {
  202. auto const& function_declaration = m_functions_to_hoist[i];
  203. if (m_lexical_names.contains(function_declaration.name()) || m_forbidden_var_names.contains(function_declaration.name()))
  204. continue;
  205. if (is_top_level()) {
  206. m_node->add_hoisted_function(move(m_functions_to_hoist[i]));
  207. } else {
  208. if (!m_parent_scope->m_lexical_names.contains(function_declaration.name()) && !m_parent_scope->m_function_names.contains(function_declaration.name()))
  209. m_parent_scope->m_functions_to_hoist.append(move(m_functions_to_hoist[i]));
  210. }
  211. }
  212. if (m_parent_scope && !m_function_parameters.has_value()) {
  213. m_parent_scope->m_contains_access_to_arguments_object |= m_contains_access_to_arguments_object;
  214. m_parent_scope->m_contains_direct_call_to_eval |= m_contains_direct_call_to_eval;
  215. }
  216. VERIFY(m_parser.m_state.current_scope_pusher == this);
  217. m_parser.m_state.current_scope_pusher = m_parent_scope;
  218. }
  219. void associate_identifier_with_argument_index(NonnullRefPtr<Identifier> identifier, size_t index)
  220. {
  221. m_identifier_and_argument_index_associations.ensure(index).append(move(identifier));
  222. }
  223. void set_contains_await_expression()
  224. {
  225. m_contains_await_expression = true;
  226. }
  227. bool contains_await_expression() const
  228. {
  229. return m_contains_await_expression;
  230. }
  231. private:
  232. void throw_identifier_declared(FlyString const& name, NonnullRefPtr<Declaration> const& declaration)
  233. {
  234. m_parser.syntax_error(String::formatted("Identifier '{}' already declared", name), declaration->source_range().start);
  235. }
  236. Parser& m_parser;
  237. ScopeNode* m_node { nullptr };
  238. ScopeLevel m_scope_level { ScopeLevel::NotTopLevel };
  239. ScopePusher* m_parent_scope { nullptr };
  240. ScopePusher* m_top_level_scope { nullptr };
  241. HashTable<FlyString> m_lexical_names;
  242. HashTable<FlyString> m_var_names;
  243. HashTable<FlyString> m_function_names;
  244. HashTable<FlyString> m_forbidden_lexical_names;
  245. HashTable<FlyString> m_forbidden_var_names;
  246. NonnullRefPtrVector<FunctionDeclaration> m_functions_to_hoist;
  247. Optional<Vector<FunctionDeclaration::Parameter>> m_function_parameters;
  248. HashMap<size_t, NonnullRefPtrVector<Identifier>> m_identifier_and_argument_index_associations;
  249. bool m_contains_access_to_arguments_object { false };
  250. bool m_contains_direct_call_to_eval { false };
  251. bool m_contains_await_expression { false };
  252. };
  253. class OperatorPrecedenceTable {
  254. public:
  255. constexpr OperatorPrecedenceTable()
  256. : m_token_precedence()
  257. {
  258. for (size_t i = 0; i < array_size(m_operator_precedence); ++i) {
  259. auto& op = m_operator_precedence[i];
  260. m_token_precedence[static_cast<size_t>(op.token)] = op.precedence;
  261. }
  262. }
  263. constexpr int get(TokenType token) const
  264. {
  265. int p = m_token_precedence[static_cast<size_t>(token)];
  266. if (p == 0) {
  267. warnln("Internal Error: No precedence for operator {}", Token::name(token));
  268. VERIFY_NOT_REACHED();
  269. return -1;
  270. }
  271. return p;
  272. }
  273. private:
  274. int m_token_precedence[cs_num_of_js_tokens];
  275. struct OperatorPrecedence {
  276. TokenType token;
  277. int precedence;
  278. };
  279. // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence
  280. static constexpr const OperatorPrecedence m_operator_precedence[] = {
  281. { TokenType::Period, 20 },
  282. { TokenType::BracketOpen, 20 },
  283. { TokenType::ParenOpen, 20 },
  284. { TokenType::QuestionMarkPeriod, 20 },
  285. { TokenType::New, 19 },
  286. { TokenType::PlusPlus, 18 },
  287. { TokenType::MinusMinus, 18 },
  288. { TokenType::ExclamationMark, 17 },
  289. { TokenType::Tilde, 17 },
  290. { TokenType::Typeof, 17 },
  291. { TokenType::Void, 17 },
  292. { TokenType::Delete, 17 },
  293. { TokenType::Await, 17 },
  294. { TokenType::DoubleAsterisk, 16 },
  295. { TokenType::Asterisk, 15 },
  296. { TokenType::Slash, 15 },
  297. { TokenType::Percent, 15 },
  298. { TokenType::Plus, 14 },
  299. { TokenType::Minus, 14 },
  300. { TokenType::ShiftLeft, 13 },
  301. { TokenType::ShiftRight, 13 },
  302. { TokenType::UnsignedShiftRight, 13 },
  303. { TokenType::LessThan, 12 },
  304. { TokenType::LessThanEquals, 12 },
  305. { TokenType::GreaterThan, 12 },
  306. { TokenType::GreaterThanEquals, 12 },
  307. { TokenType::In, 12 },
  308. { TokenType::Instanceof, 12 },
  309. { TokenType::EqualsEquals, 11 },
  310. { TokenType::ExclamationMarkEquals, 11 },
  311. { TokenType::EqualsEqualsEquals, 11 },
  312. { TokenType::ExclamationMarkEqualsEquals, 11 },
  313. { TokenType::Ampersand, 10 },
  314. { TokenType::Caret, 9 },
  315. { TokenType::Pipe, 8 },
  316. { TokenType::DoubleQuestionMark, 7 },
  317. { TokenType::DoubleAmpersand, 6 },
  318. { TokenType::DoublePipe, 5 },
  319. { TokenType::QuestionMark, 4 },
  320. { TokenType::Equals, 3 },
  321. { TokenType::PlusEquals, 3 },
  322. { TokenType::MinusEquals, 3 },
  323. { TokenType::DoubleAsteriskEquals, 3 },
  324. { TokenType::AsteriskEquals, 3 },
  325. { TokenType::SlashEquals, 3 },
  326. { TokenType::PercentEquals, 3 },
  327. { TokenType::ShiftLeftEquals, 3 },
  328. { TokenType::ShiftRightEquals, 3 },
  329. { TokenType::UnsignedShiftRightEquals, 3 },
  330. { TokenType::AmpersandEquals, 3 },
  331. { TokenType::CaretEquals, 3 },
  332. { TokenType::PipeEquals, 3 },
  333. { TokenType::DoubleAmpersandEquals, 3 },
  334. { TokenType::DoublePipeEquals, 3 },
  335. { TokenType::DoubleQuestionMarkEquals, 3 },
  336. { TokenType::Yield, 2 },
  337. { TokenType::Comma, 1 },
  338. };
  339. };
  340. constexpr OperatorPrecedenceTable g_operator_precedence;
  341. Parser::ParserState::ParserState(Lexer l, Program::Type program_type)
  342. : lexer(move(l))
  343. {
  344. if (program_type == Program::Type::Module)
  345. lexer.disallow_html_comments();
  346. current_token = lexer.next();
  347. }
  348. Parser::Parser(Lexer lexer, Program::Type program_type, Optional<EvalInitialState> initial_state_for_eval)
  349. : m_source_code(SourceCode::create(lexer.filename(), lexer.source()))
  350. , m_state(move(lexer), program_type)
  351. , m_program_type(program_type)
  352. {
  353. if (initial_state_for_eval.has_value()) {
  354. m_state.in_eval_function_context = initial_state_for_eval->in_eval_function_context;
  355. m_state.allow_super_property_lookup = initial_state_for_eval->allow_super_property_lookup;
  356. m_state.allow_super_constructor_call = initial_state_for_eval->allow_super_constructor_call;
  357. m_state.in_class_field_initializer = initial_state_for_eval->in_class_field_initializer;
  358. }
  359. }
  360. Associativity Parser::operator_associativity(TokenType type) const
  361. {
  362. switch (type) {
  363. case TokenType::Period:
  364. case TokenType::BracketOpen:
  365. case TokenType::ParenOpen:
  366. case TokenType::QuestionMarkPeriod:
  367. case TokenType::Asterisk:
  368. case TokenType::Slash:
  369. case TokenType::Percent:
  370. case TokenType::Plus:
  371. case TokenType::Minus:
  372. case TokenType::ShiftLeft:
  373. case TokenType::ShiftRight:
  374. case TokenType::UnsignedShiftRight:
  375. case TokenType::LessThan:
  376. case TokenType::LessThanEquals:
  377. case TokenType::GreaterThan:
  378. case TokenType::GreaterThanEquals:
  379. case TokenType::In:
  380. case TokenType::Instanceof:
  381. case TokenType::EqualsEquals:
  382. case TokenType::ExclamationMarkEquals:
  383. case TokenType::EqualsEqualsEquals:
  384. case TokenType::ExclamationMarkEqualsEquals:
  385. case TokenType::Typeof:
  386. case TokenType::Void:
  387. case TokenType::Delete:
  388. case TokenType::Await:
  389. case TokenType::Ampersand:
  390. case TokenType::Caret:
  391. case TokenType::Pipe:
  392. case TokenType::DoubleQuestionMark:
  393. case TokenType::DoubleAmpersand:
  394. case TokenType::DoublePipe:
  395. case TokenType::Comma:
  396. return Associativity::Left;
  397. default:
  398. return Associativity::Right;
  399. }
  400. }
  401. bool Parser::parse_directive(ScopeNode& body)
  402. {
  403. bool found_use_strict = false;
  404. while (!done() && match(TokenType::StringLiteral)) {
  405. // It cannot be a labelled function since we hit a string literal.
  406. auto statement = parse_statement(AllowLabelledFunction::No);
  407. body.append(statement);
  408. VERIFY(is<ExpressionStatement>(*statement));
  409. auto& expression = static_cast<ExpressionStatement const&>(*statement).expression();
  410. if (!is<StringLiteral>(expression))
  411. break;
  412. auto& string_literal = static_cast<StringLiteral const&>(expression);
  413. if (string_literal.is_use_strict_directive()) {
  414. found_use_strict = true;
  415. if (m_state.string_legacy_octal_escape_sequence_in_scope)
  416. syntax_error("Octal escape sequence in string literal not allowed in strict mode");
  417. break;
  418. }
  419. }
  420. m_state.string_legacy_octal_escape_sequence_in_scope = false;
  421. return found_use_strict;
  422. }
  423. NonnullRefPtr<Program> Parser::parse_program(bool starts_in_strict_mode)
  424. {
  425. auto rule_start = push_start();
  426. auto program = adopt_ref(*new Program({ m_source_code, rule_start.position(), position() }, m_program_type));
  427. ScopePusher program_scope = ScopePusher::program_scope(*this, *program);
  428. if (m_program_type == Program::Type::Script)
  429. parse_script(program, starts_in_strict_mode);
  430. else
  431. parse_module(program);
  432. program->source_range().end = position();
  433. return program;
  434. }
  435. void Parser::parse_script(Program& program, bool starts_in_strict_mode)
  436. {
  437. bool strict_before = m_state.strict_mode;
  438. if (starts_in_strict_mode)
  439. m_state.strict_mode = true;
  440. bool has_use_strict = parse_directive(program);
  441. if (m_state.strict_mode || has_use_strict) {
  442. program.set_strict_mode();
  443. m_state.strict_mode = true;
  444. }
  445. parse_statement_list(program, AllowLabelledFunction::Yes);
  446. if (!done()) {
  447. expected("statement or declaration");
  448. consume();
  449. }
  450. m_state.strict_mode = strict_before;
  451. }
  452. void Parser::parse_module(Program& program)
  453. {
  454. TemporaryChange strict_mode_rollback(m_state.strict_mode, true);
  455. TemporaryChange await_expression_valid_rollback(m_state.await_expression_is_valid, true);
  456. // Since strict mode is already enabled we skip any directive parsing.
  457. while (!done()) {
  458. parse_statement_list(program, AllowLabelledFunction::Yes);
  459. if (done())
  460. break;
  461. if (match_export_or_import()) {
  462. VERIFY(m_state.current_token.type() == TokenType::Export || m_state.current_token.type() == TokenType::Import);
  463. if (m_state.current_token.type() == TokenType::Export)
  464. program.append_export(parse_export_statement(program));
  465. else
  466. program.append_import(parse_import_statement(program));
  467. } else {
  468. expected("statement or declaration");
  469. consume();
  470. }
  471. }
  472. VERIFY(m_state.current_scope_pusher);
  473. if (m_state.current_scope_pusher->contains_await_expression())
  474. program.set_has_top_level_await();
  475. for (auto& export_statement : program.exports()) {
  476. if (export_statement.has_statement())
  477. continue;
  478. for (auto& entry : export_statement.entries()) {
  479. if (entry.is_module_request() || entry.kind == ExportStatement::ExportEntry::Kind::EmptyNamedExport)
  480. return;
  481. auto const& exported_name = entry.local_or_import_name;
  482. bool found = false;
  483. program.for_each_lexically_declared_name([&](auto const& name) {
  484. if (name == exported_name)
  485. found = true;
  486. });
  487. if (found)
  488. continue;
  489. program.for_each_var_declared_name([&](auto const& name) {
  490. if (name == exported_name)
  491. found = true;
  492. });
  493. for (auto& import : program.imports()) {
  494. if (import.has_bound_name(exported_name)) {
  495. found = true;
  496. break;
  497. }
  498. }
  499. if (!found)
  500. syntax_error(String::formatted("'{}' in export is not declared", exported_name), export_statement.source_range().start);
  501. }
  502. }
  503. }
  504. NonnullRefPtr<Declaration> Parser::parse_declaration()
  505. {
  506. auto rule_start = push_start();
  507. if (m_state.current_token.type() == TokenType::Async && next_token().type() == TokenType::Function)
  508. return parse_function_node<FunctionDeclaration>();
  509. switch (m_state.current_token.type()) {
  510. case TokenType::Class:
  511. return parse_class_declaration();
  512. case TokenType::Function:
  513. return parse_function_node<FunctionDeclaration>();
  514. case TokenType::Let:
  515. case TokenType::Const:
  516. return parse_variable_declaration();
  517. default:
  518. expected("declaration");
  519. consume();
  520. return create_ast_node<ErrorDeclaration>({ m_source_code, rule_start.position(), position() });
  521. }
  522. }
  523. NonnullRefPtr<Statement> Parser::parse_statement(AllowLabelledFunction allow_labelled_function)
  524. {
  525. auto rule_start = push_start();
  526. auto type = m_state.current_token.type();
  527. switch (type) {
  528. case TokenType::CurlyOpen:
  529. return parse_block_statement();
  530. case TokenType::Return:
  531. return parse_return_statement();
  532. case TokenType::Var: {
  533. auto declaration = parse_variable_declaration();
  534. m_state.current_scope_pusher->add_declaration(declaration);
  535. return declaration;
  536. }
  537. case TokenType::For:
  538. return parse_for_statement();
  539. case TokenType::If:
  540. return parse_if_statement();
  541. case TokenType::Throw:
  542. return parse_throw_statement();
  543. case TokenType::Try:
  544. return parse_try_statement();
  545. case TokenType::Break:
  546. return parse_break_statement();
  547. case TokenType::Continue:
  548. return parse_continue_statement();
  549. case TokenType::Switch:
  550. return parse_switch_statement();
  551. case TokenType::Do:
  552. return parse_do_while_statement();
  553. case TokenType::While:
  554. return parse_while_statement();
  555. case TokenType::With:
  556. if (m_state.strict_mode)
  557. syntax_error("'with' statement not allowed in strict mode");
  558. return parse_with_statement();
  559. case TokenType::Debugger:
  560. return parse_debugger_statement();
  561. case TokenType::Semicolon:
  562. consume();
  563. return create_ast_node<EmptyStatement>({ m_source_code, rule_start.position(), position() });
  564. case TokenType::Slash:
  565. case TokenType::SlashEquals:
  566. m_state.current_token = m_state.lexer.force_slash_as_regex();
  567. [[fallthrough]];
  568. default:
  569. if (match_invalid_escaped_keyword())
  570. syntax_error("Keyword must not contain escaped characters");
  571. if (match_identifier_name()) {
  572. auto result = try_parse_labelled_statement(allow_labelled_function);
  573. if (!result.is_null())
  574. return result.release_nonnull();
  575. }
  576. if (match_expression()) {
  577. if (match(TokenType::Async)) {
  578. auto lookahead_token = next_token();
  579. if (lookahead_token.type() == TokenType::Function && !lookahead_token.trivia_contains_line_terminator())
  580. syntax_error("Async function declaration not allowed in single-statement context");
  581. } else if (match(TokenType::Function) || match(TokenType::Class)) {
  582. syntax_error(String::formatted("{} declaration not allowed in single-statement context", m_state.current_token.name()));
  583. } else if (match(TokenType::Let) && next_token().type() == TokenType::BracketOpen) {
  584. syntax_error(String::formatted("let followed by [ is not allowed in single-statement context"));
  585. }
  586. auto expr = parse_expression(0);
  587. consume_or_insert_semicolon();
  588. return create_ast_node<ExpressionStatement>({ m_source_code, rule_start.position(), position() }, move(expr));
  589. }
  590. expected("statement");
  591. consume();
  592. return create_ast_node<ErrorStatement>({ m_source_code, rule_start.position(), position() });
  593. }
  594. }
  595. bool Parser::match_invalid_escaped_keyword() const
  596. {
  597. if (m_state.current_token.type() != TokenType::EscapedKeyword)
  598. return false;
  599. auto token_value = m_state.current_token.value();
  600. if (token_value == "await"sv)
  601. return m_program_type == Program::Type::Module || m_state.await_expression_is_valid;
  602. if (token_value == "async"sv)
  603. return false;
  604. if (token_value == "yield"sv)
  605. return m_state.in_generator_function_context;
  606. if (m_state.strict_mode)
  607. return true;
  608. return token_value != "let"sv;
  609. }
  610. static constexpr AK::Array<StringView, 9> strict_reserved_words = { "implements"sv, "interface"sv, "let"sv, "package"sv, "private"sv, "protected"sv, "public"sv, "static"sv, "yield"sv };
  611. static bool is_strict_reserved_word(StringView str)
  612. {
  613. return any_of(strict_reserved_words, [&str](StringView word) {
  614. return word == str;
  615. });
  616. }
  617. static bool is_simple_parameter_list(Vector<FunctionNode::Parameter> const& parameters)
  618. {
  619. return all_of(parameters, [](FunctionNode::Parameter const& parameter) {
  620. return !parameter.is_rest && parameter.default_value.is_null() && parameter.binding.has<FlyString>();
  621. });
  622. }
  623. RefPtr<FunctionExpression> Parser::try_parse_arrow_function_expression(bool expect_parens, bool is_async)
  624. {
  625. if (is_async)
  626. VERIFY(match(TokenType::Async));
  627. if (!expect_parens && !is_async) {
  628. // NOTE: This is a fast path where we try to fail early in case this can't possibly
  629. // be a match. The idea is to avoid the expensive parser state save/load mechanism.
  630. // The logic is duplicated below in the "real" !expect_parens branch.
  631. if (!match_identifier() && !match(TokenType::Yield) && !match(TokenType::Await))
  632. return nullptr;
  633. auto token = next_token();
  634. if (token.trivia_contains_line_terminator())
  635. return nullptr;
  636. if (token.type() != TokenType::Arrow)
  637. return nullptr;
  638. }
  639. save_state();
  640. auto rule_start = (expect_parens && !is_async)
  641. // Someone has consumed the opening parenthesis for us! Start there.
  642. ? RulePosition { *this, m_rule_starts.last() }
  643. // We've not encountered one yet, so the rule start is actually here.
  644. : push_start();
  645. ArmedScopeGuard state_rollback_guard = [&] {
  646. load_state();
  647. };
  648. auto function_kind = FunctionKind::Normal;
  649. if (is_async) {
  650. consume(TokenType::Async);
  651. function_kind = FunctionKind::Async;
  652. if (m_state.current_token.trivia_contains_line_terminator())
  653. return nullptr;
  654. // Since we have async it can be followed by paren open in the expect_parens case
  655. // so we also consume that token.
  656. if (expect_parens) {
  657. VERIFY(match(TokenType::ParenOpen));
  658. consume(TokenType::ParenOpen);
  659. }
  660. }
  661. Vector<FunctionNode::Parameter> parameters;
  662. i32 function_length = -1;
  663. if (expect_parens) {
  664. // We have parens around the function parameters and can re-use the same parsing
  665. // logic used for regular functions: multiple parameters, default values, rest
  666. // parameter, maybe a trailing comma. If we have a new syntax error afterwards we
  667. // check if it's about a wrong token (something like duplicate parameter name must
  668. // not abort), know parsing failed and rollback the parser state.
  669. auto previous_syntax_errors = m_state.errors.size();
  670. TemporaryChange in_async_context(m_state.await_expression_is_valid, is_async || m_state.await_expression_is_valid);
  671. parameters = parse_formal_parameters(function_length, FunctionNodeParseOptions::IsArrowFunction | (is_async ? FunctionNodeParseOptions::IsAsyncFunction : 0));
  672. if (m_state.errors.size() > previous_syntax_errors && m_state.errors[previous_syntax_errors].message.starts_with("Unexpected token"sv))
  673. return nullptr;
  674. if (!match(TokenType::ParenClose))
  675. return nullptr;
  676. consume();
  677. } else {
  678. // No parens - this must be an identifier followed by arrow. That's it.
  679. if (!match_identifier() && !match(TokenType::Yield) && !match(TokenType::Await))
  680. return nullptr;
  681. auto token = consume_identifier_reference();
  682. if (m_state.strict_mode && token.value().is_one_of("arguments"sv, "eval"sv))
  683. syntax_error("BindingIdentifier may not be 'arguments' or 'eval' in strict mode");
  684. if (is_async && token.value() == "await"sv)
  685. syntax_error("'await' is a reserved identifier in async functions");
  686. parameters.append({ FlyString { token.value() }, {} });
  687. }
  688. // If there's a newline between the closing paren and arrow it's not a valid arrow function,
  689. // ASI should kick in instead (it'll then fail with "Unexpected token Arrow")
  690. if (m_state.current_token.trivia_contains_line_terminator())
  691. return nullptr;
  692. if (!match(TokenType::Arrow))
  693. return nullptr;
  694. consume();
  695. if (function_length == -1)
  696. function_length = parameters.size();
  697. auto old_labels_in_scope = move(m_state.labels_in_scope);
  698. ScopeGuard guard([&]() {
  699. m_state.labels_in_scope = move(old_labels_in_scope);
  700. });
  701. bool contains_direct_call_to_eval = false;
  702. auto function_body_result = [&]() -> RefPtr<FunctionBody> {
  703. TemporaryChange change(m_state.in_arrow_function_context, true);
  704. TemporaryChange async_context_change(m_state.await_expression_is_valid, is_async);
  705. TemporaryChange in_class_static_init_block_change(m_state.in_class_static_init_block, false);
  706. if (match(TokenType::CurlyOpen)) {
  707. // Parse a function body with statements
  708. consume(TokenType::CurlyOpen);
  709. auto body = parse_function_body(parameters, function_kind, contains_direct_call_to_eval);
  710. consume(TokenType::CurlyClose);
  711. return body;
  712. }
  713. if (match_expression()) {
  714. // Parse a function body which returns a single expression
  715. // FIXME: We synthesize a block with a return statement
  716. // for arrow function bodies which are a single expression.
  717. // Esprima generates a single "ArrowFunctionExpression"
  718. // with a "body" property.
  719. auto return_block = create_ast_node<FunctionBody>({ m_source_code, rule_start.position(), position() });
  720. ScopePusher function_scope = ScopePusher::function_scope(*this, return_block, parameters);
  721. auto return_expression = parse_expression(2);
  722. return_block->append<ReturnStatement>({ m_source_code, rule_start.position(), position() }, move(return_expression));
  723. if (m_state.strict_mode)
  724. return_block->set_strict_mode();
  725. contains_direct_call_to_eval = function_scope.contains_direct_call_to_eval();
  726. return return_block;
  727. }
  728. // Invalid arrow function body
  729. return nullptr;
  730. }();
  731. if (function_body_result.is_null())
  732. return nullptr;
  733. state_rollback_guard.disarm();
  734. discard_saved_state();
  735. auto body = function_body_result.release_nonnull();
  736. if (body->in_strict_mode()) {
  737. for (auto& parameter : parameters) {
  738. parameter.binding.visit(
  739. [&](FlyString const& name) {
  740. check_identifier_name_for_assignment_validity(name, true);
  741. },
  742. [&](auto const&) {});
  743. }
  744. }
  745. auto function_start_offset = rule_start.position().offset;
  746. auto function_end_offset = position().offset - m_state.current_token.trivia().length();
  747. auto source_text = String { m_state.lexer.source().substring_view(function_start_offset, function_end_offset - function_start_offset) };
  748. return create_ast_node<FunctionExpression>(
  749. { m_source_code, rule_start.position(), position() }, "", move(source_text),
  750. move(body), move(parameters), function_length, function_kind, body->in_strict_mode(),
  751. /* might_need_arguments_object */ false, contains_direct_call_to_eval, /* is_arrow_function */ true);
  752. }
  753. RefPtr<LabelledStatement> Parser::try_parse_labelled_statement(AllowLabelledFunction allow_function)
  754. {
  755. {
  756. // NOTE: This is a fast path where we try to fail early to avoid the expensive save_state+load_state.
  757. if (next_token().type() != TokenType::Colon)
  758. return {};
  759. }
  760. save_state();
  761. auto rule_start = push_start();
  762. ArmedScopeGuard state_rollback_guard = [&] {
  763. load_state();
  764. };
  765. if (m_state.current_token.value() == "yield"sv && (m_state.strict_mode || m_state.in_generator_function_context)) {
  766. return {};
  767. }
  768. if (m_state.current_token.value() == "await"sv && (m_program_type == Program::Type::Module || m_state.await_expression_is_valid || m_state.in_class_static_init_block)) {
  769. return {};
  770. }
  771. auto identifier = [&] {
  772. if (m_state.current_token.value() == "await"sv) {
  773. return consume().value();
  774. }
  775. return consume_identifier_reference().value();
  776. }();
  777. if (!match(TokenType::Colon))
  778. return {};
  779. consume(TokenType::Colon);
  780. if (!match_statement())
  781. return {};
  782. state_rollback_guard.disarm();
  783. discard_saved_state();
  784. if (m_state.strict_mode && identifier == "let"sv) {
  785. syntax_error("Strict mode reserved word 'let' is not allowed in label", rule_start.position());
  786. return {};
  787. }
  788. if (match(TokenType::Function) && (allow_function == AllowLabelledFunction::No || m_state.strict_mode)) {
  789. syntax_error("Not allowed to declare a function here");
  790. return {};
  791. }
  792. if (m_state.labels_in_scope.contains(identifier))
  793. syntax_error(String::formatted("Label '{}' has already been declared", identifier));
  794. RefPtr<Statement> labelled_item;
  795. auto is_iteration_statement = false;
  796. if (match(TokenType::Function)) {
  797. m_state.labels_in_scope.set(identifier, {});
  798. auto function_declaration = parse_function_node<FunctionDeclaration>();
  799. VERIFY(m_state.current_scope_pusher);
  800. m_state.current_scope_pusher->add_declaration(function_declaration);
  801. if (function_declaration->kind() == FunctionKind::Generator)
  802. syntax_error("Generator functions cannot be defined in labelled statements");
  803. if (function_declaration->kind() == FunctionKind::Async)
  804. syntax_error("Async functions cannot be defined in labelled statements");
  805. labelled_item = move(function_declaration);
  806. } else {
  807. m_state.labels_in_scope.set(identifier, {});
  808. labelled_item = parse_statement(allow_function);
  809. // Extract the innermost statement from a potentially nested chain of LabelledStatements.
  810. auto statement = labelled_item;
  811. while (is<LabelledStatement>(*statement))
  812. statement = static_cast<LabelledStatement&>(*statement).labelled_item();
  813. if (is<IterationStatement>(*statement))
  814. is_iteration_statement = true;
  815. }
  816. if (!is_iteration_statement) {
  817. if (auto entry = m_state.labels_in_scope.find(identifier); entry != m_state.labels_in_scope.end() && entry->value.has_value())
  818. syntax_error("labelled continue statement cannot use non iterating statement", m_state.labels_in_scope.get(identifier).value());
  819. }
  820. m_state.labels_in_scope.remove(identifier);
  821. return create_ast_node<LabelledStatement>({ m_source_code, rule_start.position(), position() }, identifier, labelled_item.release_nonnull());
  822. }
  823. RefPtr<MetaProperty> Parser::try_parse_new_target_expression()
  824. {
  825. // Optimization which skips the save/load state.
  826. if (next_token().type() != TokenType::Period)
  827. return {};
  828. save_state();
  829. auto rule_start = push_start();
  830. ArmedScopeGuard state_rollback_guard = [&] {
  831. load_state();
  832. };
  833. consume(TokenType::New);
  834. consume(TokenType::Period);
  835. if (!match(TokenType::Identifier))
  836. return {};
  837. // The string 'target' cannot have escapes so we check original value.
  838. if (consume().original_value() != "target"sv)
  839. return {};
  840. state_rollback_guard.disarm();
  841. discard_saved_state();
  842. return create_ast_node<MetaProperty>({ m_source_code, rule_start.position(), position() }, MetaProperty::Type::NewTarget);
  843. }
  844. RefPtr<MetaProperty> Parser::try_parse_import_meta_expression()
  845. {
  846. // Optimization which skips the save/load state.
  847. if (next_token().type() != TokenType::Period)
  848. return {};
  849. save_state();
  850. auto rule_start = push_start();
  851. ArmedScopeGuard state_rollback_guard = [&] {
  852. load_state();
  853. };
  854. consume(TokenType::Import);
  855. consume(TokenType::Period);
  856. if (!match(TokenType::Identifier))
  857. return {};
  858. // The string 'meta' cannot have escapes so we check original value.
  859. if (consume().original_value() != "meta"sv)
  860. return {};
  861. state_rollback_guard.disarm();
  862. discard_saved_state();
  863. return create_ast_node<MetaProperty>({ m_source_code, rule_start.position(), position() }, MetaProperty::Type::ImportMeta);
  864. }
  865. NonnullRefPtr<ImportCall> Parser::parse_import_call()
  866. {
  867. auto rule_start = push_start();
  868. // We use the extended definition:
  869. // ImportCall[Yield, Await]:
  870. // import(AssignmentExpression[+In, ?Yield, ?Await] ,opt)
  871. // import(AssignmentExpression[+In, ?Yield, ?Await] ,AssignmentExpression[+In, ?Yield, ?Await] ,opt)
  872. // From https://tc39.es/proposal-import-assertions/#sec-evaluate-import-call
  873. consume(TokenType::Import);
  874. consume(TokenType::ParenOpen);
  875. auto argument = parse_expression(2);
  876. RefPtr<Expression> options;
  877. if (match(TokenType::Comma)) {
  878. consume(TokenType::Comma);
  879. if (!match(TokenType::ParenClose)) {
  880. options = parse_expression(2);
  881. // Second optional comma
  882. if (match(TokenType::Comma))
  883. consume(TokenType::Comma);
  884. }
  885. }
  886. consume(TokenType::ParenClose);
  887. return create_ast_node<ImportCall>({ m_source_code, rule_start.position(), position() }, move(argument), move(options));
  888. }
  889. NonnullRefPtr<ClassDeclaration> Parser::parse_class_declaration()
  890. {
  891. auto rule_start = push_start();
  892. return create_ast_node<ClassDeclaration>({ m_source_code, rule_start.position(), position() }, parse_class_expression(true));
  893. }
  894. NonnullRefPtr<ClassExpression> Parser::parse_class_expression(bool expect_class_name)
  895. {
  896. auto rule_start = push_start();
  897. // Classes are always in strict mode.
  898. TemporaryChange strict_mode_rollback(m_state.strict_mode, true);
  899. consume(TokenType::Class);
  900. NonnullRefPtrVector<ClassElement> elements;
  901. RefPtr<Expression> super_class;
  902. RefPtr<FunctionExpression> constructor;
  903. HashTable<FlyString> found_private_names;
  904. FlyString class_name = expect_class_name || match_identifier() || match(TokenType::Yield) || match(TokenType::Await)
  905. ? consume_identifier_reference().flystring_value()
  906. : "";
  907. check_identifier_name_for_assignment_validity(class_name, true);
  908. if (m_state.in_class_static_init_block && class_name == "await"sv)
  909. syntax_error("Identifier must not be a reserved word in modules ('await')");
  910. if (match(TokenType::Extends)) {
  911. consume();
  912. auto [expression, should_continue_parsing] = parse_primary_expression();
  913. // Basically a (much) simplified parse_secondary_expression().
  914. for (;;) {
  915. if (match(TokenType::TemplateLiteralStart)) {
  916. auto template_literal = parse_template_literal(true);
  917. expression = create_ast_node<TaggedTemplateLiteral>({ m_source_code, rule_start.position(), position() }, move(expression), move(template_literal));
  918. continue;
  919. }
  920. if (match(TokenType::BracketOpen) || match(TokenType::Period) || match(TokenType::ParenOpen)) {
  921. auto precedence = g_operator_precedence.get(m_state.current_token.type());
  922. expression = parse_secondary_expression(move(expression), precedence).expression;
  923. continue;
  924. }
  925. break;
  926. }
  927. super_class = move(expression);
  928. (void)should_continue_parsing;
  929. }
  930. consume(TokenType::CurlyOpen);
  931. HashTable<StringView> referenced_private_names;
  932. HashTable<StringView>* outer_referenced_private_names = m_state.referenced_private_names;
  933. m_state.referenced_private_names = &referenced_private_names;
  934. ScopeGuard restore_private_name_table = [&] {
  935. m_state.referenced_private_names = outer_referenced_private_names;
  936. };
  937. while (!done() && !match(TokenType::CurlyClose)) {
  938. RefPtr<Expression> property_key;
  939. bool is_static = false;
  940. bool is_constructor = false;
  941. bool is_generator = false;
  942. bool is_async = false;
  943. auto method_kind = ClassMethod::Kind::Method;
  944. if (match(TokenType::Semicolon)) {
  945. consume();
  946. continue;
  947. }
  948. auto function_start = position();
  949. if (match(TokenType::Async)) {
  950. auto lookahead_token = next_token();
  951. // If async is followed by a Semicolon or CurlyClose it is a field (CurlyClose indicates end of class)
  952. // Otherwise if it is followed by a ParenOpen it is a function named async
  953. if (lookahead_token.type() != TokenType::Semicolon && lookahead_token.type() != TokenType::CurlyClose && lookahead_token.type() != TokenType::ParenOpen
  954. && !lookahead_token.trivia_contains_line_terminator()) {
  955. consume();
  956. is_async = true;
  957. }
  958. }
  959. if (match(TokenType::Asterisk)) {
  960. consume();
  961. is_generator = true;
  962. }
  963. StringView name;
  964. if (match_property_key() || match(TokenType::PrivateIdentifier)) {
  965. if (!is_generator && !is_async && m_state.current_token.original_value() == "static"sv) {
  966. if (match(TokenType::Identifier)) {
  967. consume();
  968. is_static = true;
  969. function_start = position();
  970. if (match(TokenType::Async)) {
  971. consume();
  972. is_async = true;
  973. }
  974. if (match(TokenType::Asterisk)) {
  975. consume();
  976. is_generator = true;
  977. }
  978. }
  979. }
  980. if (match(TokenType::Identifier)) {
  981. auto identifier_name = m_state.current_token.original_value();
  982. if (identifier_name == "get"sv) {
  983. method_kind = ClassMethod::Kind::Getter;
  984. consume();
  985. } else if (identifier_name == "set"sv) {
  986. method_kind = ClassMethod::Kind::Setter;
  987. consume();
  988. }
  989. }
  990. if (match_property_key() || match(TokenType::PrivateIdentifier)) {
  991. switch (m_state.current_token.type()) {
  992. case TokenType::Identifier:
  993. name = consume().value();
  994. property_key = create_ast_node<StringLiteral>({ m_source_code, rule_start.position(), position() }, name);
  995. break;
  996. case TokenType::PrivateIdentifier:
  997. name = consume().value();
  998. if (name == "#constructor")
  999. syntax_error("Private property with name '#constructor' is not allowed");
  1000. if (method_kind != ClassMethod::Kind::Method) {
  1001. // It is a Syntax Error if PrivateBoundIdentifiers of ClassElementList contains any duplicate entries,
  1002. // unless the name is used once for a getter and once for a setter and in no other entries,
  1003. // and the getter and setter are either both static or both non-static.
  1004. for (auto& element : elements) {
  1005. auto private_name = element.private_bound_identifier();
  1006. if (!private_name.has_value() || private_name.value() != name)
  1007. continue;
  1008. if (element.class_element_kind() != ClassElement::ElementKind::Method
  1009. || element.is_static() != is_static) {
  1010. syntax_error(String::formatted("Duplicate private field or method named '{}'", name));
  1011. break;
  1012. }
  1013. VERIFY(is<ClassMethod>(element));
  1014. auto& class_method_element = static_cast<ClassMethod const&>(element);
  1015. if (class_method_element.kind() == ClassMethod::Kind::Method || class_method_element.kind() == method_kind) {
  1016. syntax_error(String::formatted("Duplicate private field or method named '{}'", name));
  1017. break;
  1018. }
  1019. }
  1020. found_private_names.set(name);
  1021. } else if (found_private_names.set(name) != AK::HashSetResult::InsertedNewEntry) {
  1022. syntax_error(String::formatted("Duplicate private field or method named '{}'", name));
  1023. }
  1024. property_key = create_ast_node<PrivateIdentifier>({ m_source_code, rule_start.position(), position() }, name);
  1025. break;
  1026. case TokenType::StringLiteral: {
  1027. auto string_literal = parse_string_literal(consume());
  1028. name = string_literal->value();
  1029. property_key = move(string_literal);
  1030. break;
  1031. }
  1032. default:
  1033. property_key = parse_property_key();
  1034. break;
  1035. }
  1036. // https://tc39.es/ecma262/#sec-class-definitions-static-semantics-early-errors
  1037. // ClassElement : static MethodDefinition
  1038. // It is a Syntax Error if PropName of MethodDefinition is "prototype".
  1039. if (is_static && name == "prototype"sv)
  1040. syntax_error("Classes may not have a static property named 'prototype'");
  1041. } else if ((match(TokenType::ParenOpen) || match(TokenType::Equals) || match(TokenType::Semicolon) || match(TokenType::CurlyClose)) && (is_static || is_async || method_kind != ClassMethod::Kind::Method)) {
  1042. switch (method_kind) {
  1043. case ClassMethod::Kind::Method:
  1044. if (is_async) {
  1045. name = "async"sv;
  1046. is_async = false;
  1047. } else {
  1048. VERIFY(is_static);
  1049. name = "static"sv;
  1050. is_static = false;
  1051. }
  1052. break;
  1053. case ClassMethod::Kind::Getter:
  1054. name = "get"sv;
  1055. method_kind = ClassMethod::Kind::Method;
  1056. break;
  1057. case ClassMethod::Kind::Setter:
  1058. name = "set"sv;
  1059. method_kind = ClassMethod::Kind::Method;
  1060. break;
  1061. }
  1062. property_key = create_ast_node<StringLiteral>({ m_source_code, rule_start.position(), position() }, name);
  1063. } else if (match(TokenType::CurlyOpen) && is_static) {
  1064. auto static_start = push_start();
  1065. consume(TokenType::CurlyOpen);
  1066. auto static_init_block = create_ast_node<FunctionBody>({ m_source_code, rule_start.position(), position() });
  1067. TemporaryChange break_context_rollback(m_state.in_break_context, false);
  1068. TemporaryChange continue_context_rollback(m_state.in_continue_context, false);
  1069. TemporaryChange function_context_rollback(m_state.in_function_context, false);
  1070. TemporaryChange generator_function_context_rollback(m_state.in_generator_function_context, false);
  1071. TemporaryChange async_function_context_rollback(m_state.await_expression_is_valid, false);
  1072. TemporaryChange class_field_initializer_rollback(m_state.in_class_field_initializer, true);
  1073. TemporaryChange class_static_init_block_rollback(m_state.in_class_static_init_block, true);
  1074. TemporaryChange super_property_access_rollback(m_state.allow_super_property_lookup, true);
  1075. ScopePusher static_init_scope = ScopePusher::static_init_block_scope(*this, *static_init_block);
  1076. parse_statement_list(static_init_block);
  1077. consume(TokenType::CurlyClose);
  1078. elements.append(create_ast_node<StaticInitializer>({ m_source_code, static_start.position(), position() }, move(static_init_block), static_init_scope.contains_direct_call_to_eval()));
  1079. continue;
  1080. } else {
  1081. expected("property key");
  1082. }
  1083. // Constructor may be a StringLiteral or an Identifier.
  1084. if (!is_static && name == "constructor"sv) {
  1085. if (method_kind != ClassMethod::Kind::Method)
  1086. syntax_error("Class constructor may not be an accessor");
  1087. if (!constructor.is_null())
  1088. syntax_error("Classes may not have more than one constructor");
  1089. if (is_generator)
  1090. syntax_error("Class constructor may not be a generator");
  1091. if (is_async)
  1092. syntax_error("Class constructor may not be async");
  1093. is_constructor = true;
  1094. }
  1095. }
  1096. if (match(TokenType::ParenOpen)) {
  1097. u8 parse_options = FunctionNodeParseOptions::AllowSuperPropertyLookup;
  1098. if (!super_class.is_null() && !is_static && is_constructor)
  1099. parse_options |= FunctionNodeParseOptions::AllowSuperConstructorCall;
  1100. if (method_kind == ClassMethod::Kind::Getter)
  1101. parse_options |= FunctionNodeParseOptions::IsGetterFunction;
  1102. if (method_kind == ClassMethod::Kind::Setter)
  1103. parse_options |= FunctionNodeParseOptions::IsSetterFunction;
  1104. if (is_generator)
  1105. parse_options |= FunctionNodeParseOptions::IsGeneratorFunction;
  1106. if (is_async)
  1107. parse_options |= FunctionNodeParseOptions::IsAsyncFunction;
  1108. auto function = parse_function_node<FunctionExpression>(parse_options, function_start);
  1109. if (is_constructor) {
  1110. constructor = move(function);
  1111. } else if (!property_key.is_null()) {
  1112. elements.append(create_ast_node<ClassMethod>({ m_source_code, rule_start.position(), position() }, property_key.release_nonnull(), move(function), method_kind, is_static));
  1113. } else {
  1114. syntax_error("No key for class method");
  1115. }
  1116. } else if (is_generator || is_async) {
  1117. expected("ParenOpen");
  1118. consume();
  1119. } else if (property_key.is_null()) {
  1120. expected("property key");
  1121. consume();
  1122. } else {
  1123. if (name == "constructor"sv)
  1124. syntax_error("Class cannot have field named 'constructor'");
  1125. RefPtr<Expression> initializer;
  1126. bool contains_direct_call_to_eval = false;
  1127. if (match(TokenType::Equals)) {
  1128. consume();
  1129. TemporaryChange super_property_access_rollback(m_state.allow_super_property_lookup, true);
  1130. TemporaryChange field_initializer_rollback(m_state.in_class_field_initializer, true);
  1131. auto class_field_scope = ScopePusher::class_field_scope(*this);
  1132. initializer = parse_expression(2);
  1133. contains_direct_call_to_eval = class_field_scope.contains_direct_call_to_eval();
  1134. }
  1135. elements.append(create_ast_node<ClassField>({ m_source_code, rule_start.position(), position() }, property_key.release_nonnull(), move(initializer), contains_direct_call_to_eval, is_static));
  1136. consume_or_insert_semicolon();
  1137. }
  1138. }
  1139. consume(TokenType::CurlyClose);
  1140. if (constructor.is_null()) {
  1141. auto constructor_body = create_ast_node<BlockStatement>({ m_source_code, rule_start.position(), position() });
  1142. if (!super_class.is_null()) {
  1143. // Set constructor to the result of parsing the source text
  1144. // constructor(... args){ super (...args);}
  1145. // However: The most notable distinction is that while the aforementioned ECMAScript
  1146. // source text observably calls the @@iterator method on %Array.prototype%,
  1147. // this function does not.
  1148. // So we use a custom version of SuperCall which doesn't use the @@iterator
  1149. // method on %Array.prototype% visibly.
  1150. FlyString argument_name = "args";
  1151. auto super_call = create_ast_node<SuperCall>(
  1152. { m_source_code, rule_start.position(), position() },
  1153. SuperCall::IsPartOfSyntheticConstructor::Yes,
  1154. CallExpression::Argument { create_ast_node<Identifier>({ m_source_code, rule_start.position(), position() }, "args"), true });
  1155. // NOTE: While the JS approximation above doesn't do `return super(...args)`, the
  1156. // abstract closure is expected to capture and return the result, so we do need a
  1157. // return statement here to create the correct completion.
  1158. constructor_body->append(create_ast_node<ReturnStatement>({ m_source_code, rule_start.position(), position() }, move(super_call)));
  1159. constructor = create_ast_node<FunctionExpression>(
  1160. { m_source_code, rule_start.position(), position() }, class_name, "",
  1161. move(constructor_body), Vector { FunctionNode::Parameter { move(argument_name), nullptr, true } }, 0, FunctionKind::Normal,
  1162. /* is_strict_mode */ true, /* might_need_arguments_object */ false, /* contains_direct_call_to_eval */ false);
  1163. } else {
  1164. constructor = create_ast_node<FunctionExpression>(
  1165. { m_source_code, rule_start.position(), position() }, class_name, "",
  1166. move(constructor_body), Vector<FunctionNode::Parameter> {}, 0, FunctionKind::Normal,
  1167. /* is_strict_mode */ true, /* might_need_arguments_object */ false, /* contains_direct_call_to_eval */ false);
  1168. }
  1169. }
  1170. // We could be in a subclass defined within the main class so must move all non declared private names to outer.
  1171. for (auto& private_name : referenced_private_names) {
  1172. if (found_private_names.contains(private_name))
  1173. continue;
  1174. if (outer_referenced_private_names)
  1175. outer_referenced_private_names->set(private_name);
  1176. else // FIXME: Make these error appear in the appropriate places.
  1177. syntax_error(String::formatted("Reference to undeclared private field or method '{}'", private_name));
  1178. }
  1179. auto function_start_offset = rule_start.position().offset;
  1180. auto function_end_offset = position().offset - m_state.current_token.trivia().length();
  1181. auto source_text = String { m_state.lexer.source().substring_view(function_start_offset, function_end_offset - function_start_offset) };
  1182. return create_ast_node<ClassExpression>({ m_source_code, rule_start.position(), position() }, move(class_name), move(source_text), move(constructor), move(super_class), move(elements));
  1183. }
  1184. Parser::PrimaryExpressionParseResult Parser::parse_primary_expression()
  1185. {
  1186. auto rule_start = push_start();
  1187. if (match_unary_prefixed_expression())
  1188. return { parse_unary_prefixed_expression() };
  1189. auto try_arrow_function_parse_or_fail = [this](Position const& position, bool expect_paren, bool is_async = false) -> RefPtr<FunctionExpression> {
  1190. if (try_parse_arrow_function_expression_failed_at_position(position))
  1191. return nullptr;
  1192. auto arrow_function = try_parse_arrow_function_expression(expect_paren, is_async);
  1193. if (arrow_function)
  1194. return arrow_function;
  1195. set_try_parse_arrow_function_expression_failed_at_position(position, true);
  1196. return nullptr;
  1197. };
  1198. switch (m_state.current_token.type()) {
  1199. case TokenType::ParenOpen: {
  1200. auto paren_position = position();
  1201. consume(TokenType::ParenOpen);
  1202. if ((match(TokenType::ParenClose) || match_identifier() || match(TokenType::TripleDot) || match(TokenType::CurlyOpen) || match(TokenType::BracketOpen))) {
  1203. if (auto arrow_function_result = try_arrow_function_parse_or_fail(paren_position, true))
  1204. return { arrow_function_result.release_nonnull(), false };
  1205. }
  1206. auto expression = parse_expression(0);
  1207. consume(TokenType::ParenClose);
  1208. if (is<FunctionExpression>(*expression)) {
  1209. auto& function = static_cast<FunctionExpression&>(*expression);
  1210. if (function.kind() == FunctionKind::Generator && function.name() == "yield"sv)
  1211. syntax_error("function is not allowed to be called 'yield' in this context", function.source_range().start);
  1212. if (function.kind() == FunctionKind::Async && function.name() == "await"sv)
  1213. syntax_error("function is not allowed to be called 'await' in this context", function.source_range().start);
  1214. }
  1215. return { move(expression) };
  1216. }
  1217. case TokenType::This:
  1218. consume();
  1219. return { create_ast_node<ThisExpression>({ m_source_code, rule_start.position(), position() }) };
  1220. case TokenType::Class:
  1221. return { parse_class_expression(false) };
  1222. case TokenType::Super:
  1223. consume();
  1224. if (!m_state.allow_super_property_lookup)
  1225. syntax_error("'super' keyword unexpected here");
  1226. return { create_ast_node<SuperExpression>({ m_source_code, rule_start.position(), position() }) };
  1227. case TokenType::EscapedKeyword:
  1228. if (match_invalid_escaped_keyword())
  1229. syntax_error("Keyword must not contain escaped characters");
  1230. [[fallthrough]];
  1231. case TokenType::Identifier: {
  1232. read_as_identifier:;
  1233. if (auto arrow_function_result = try_arrow_function_parse_or_fail(position(), false))
  1234. return { arrow_function_result.release_nonnull(), false };
  1235. auto string = m_state.current_token.value();
  1236. // This could be 'eval' or 'arguments' and thus needs a custom check (`eval[1] = true`)
  1237. if (m_state.strict_mode && (string == "let" || is_strict_reserved_word(string)))
  1238. syntax_error(String::formatted("Identifier must not be a reserved word in strict mode ('{}')", string));
  1239. return { parse_identifier() };
  1240. }
  1241. case TokenType::NumericLiteral:
  1242. return { create_ast_node<NumericLiteral>({ m_source_code, rule_start.position(), position() }, consume_and_validate_numeric_literal().double_value()) };
  1243. case TokenType::BigIntLiteral:
  1244. return { create_ast_node<BigIntLiteral>({ m_source_code, rule_start.position(), position() }, consume().value()) };
  1245. case TokenType::BoolLiteral:
  1246. return { create_ast_node<BooleanLiteral>({ m_source_code, rule_start.position(), position() }, consume().bool_value()) };
  1247. case TokenType::StringLiteral:
  1248. return { parse_string_literal(consume()) };
  1249. case TokenType::NullLiteral:
  1250. consume();
  1251. return { create_ast_node<NullLiteral>({ m_source_code, rule_start.position(), position() }) };
  1252. case TokenType::CurlyOpen:
  1253. return { parse_object_expression() };
  1254. case TokenType::Async: {
  1255. auto lookahead_token = next_token();
  1256. // No valid async function (arrow or not) can have a line terminator after the async since asi would kick in.
  1257. if (lookahead_token.trivia_contains_line_terminator())
  1258. goto read_as_identifier;
  1259. if (lookahead_token.type() == TokenType::Function)
  1260. return { parse_function_node<FunctionExpression>() };
  1261. if (lookahead_token.type() == TokenType::ParenOpen) {
  1262. if (auto arrow_function_result = try_arrow_function_parse_or_fail(position(), true, true))
  1263. return { arrow_function_result.release_nonnull(), false };
  1264. } else if (lookahead_token.is_identifier_name()) {
  1265. if (auto arrow_function_result = try_arrow_function_parse_or_fail(position(), false, true))
  1266. return { arrow_function_result.release_nonnull(), false };
  1267. }
  1268. goto read_as_identifier;
  1269. }
  1270. case TokenType::Function:
  1271. return { parse_function_node<FunctionExpression>() };
  1272. case TokenType::BracketOpen:
  1273. return { parse_array_expression() };
  1274. case TokenType::RegexLiteral:
  1275. return { parse_regexp_literal() };
  1276. case TokenType::TemplateLiteralStart:
  1277. return { parse_template_literal(false) };
  1278. case TokenType::New: {
  1279. auto new_start = position();
  1280. auto new_target_result = try_parse_new_target_expression();
  1281. if (!new_target_result.is_null()) {
  1282. if (!m_state.in_function_context && !m_state.in_eval_function_context && !m_state.in_class_static_init_block)
  1283. syntax_error("'new.target' not allowed outside of a function", new_start);
  1284. return { new_target_result.release_nonnull() };
  1285. }
  1286. return { parse_new_expression() };
  1287. }
  1288. case TokenType::Import: {
  1289. auto lookahead_token = next_token();
  1290. if (lookahead_token.type() == TokenType::ParenOpen)
  1291. return { parse_import_call() };
  1292. if (lookahead_token.type() == TokenType::Period) {
  1293. if (auto import_meta = try_parse_import_meta_expression()) {
  1294. if (m_program_type != Program::Type::Module)
  1295. syntax_error("import.meta is only allowed in modules");
  1296. return { import_meta.release_nonnull() };
  1297. }
  1298. } else {
  1299. consume();
  1300. expected("import.meta or import call");
  1301. }
  1302. break;
  1303. }
  1304. case TokenType::Yield:
  1305. if (!m_state.in_generator_function_context)
  1306. goto read_as_identifier;
  1307. return { parse_yield_expression(), false };
  1308. case TokenType::Await:
  1309. if (!m_state.await_expression_is_valid)
  1310. goto read_as_identifier;
  1311. return { parse_await_expression() };
  1312. case TokenType::PrivateIdentifier:
  1313. if (!is_private_identifier_valid())
  1314. syntax_error(String::formatted("Reference to undeclared private field or method '{}'", m_state.current_token.value()));
  1315. if (next_token().type() != TokenType::In)
  1316. syntax_error("Cannot have a private identifier in expression if not followed by 'in'");
  1317. return { create_ast_node<PrivateIdentifier>({ m_source_code, rule_start.position(), position() }, consume().value()) };
  1318. default:
  1319. if (match_identifier_name())
  1320. goto read_as_identifier;
  1321. break;
  1322. }
  1323. expected("primary expression");
  1324. consume();
  1325. return { create_ast_node<ErrorExpression>({ m_source_code, rule_start.position(), position() }) };
  1326. }
  1327. NonnullRefPtr<RegExpLiteral> Parser::parse_regexp_literal()
  1328. {
  1329. auto rule_start = push_start();
  1330. auto pattern = consume().value();
  1331. // Remove leading and trailing slash.
  1332. pattern = pattern.substring_view(1, pattern.length() - 2);
  1333. auto flags = String::empty();
  1334. auto parsed_flags = RegExpObject::default_flags;
  1335. if (match(TokenType::RegexFlags)) {
  1336. auto flags_start = position();
  1337. flags = consume().value();
  1338. auto parsed_flags_or_error = regex_flags_from_string(flags);
  1339. if (parsed_flags_or_error.is_error())
  1340. syntax_error(parsed_flags_or_error.release_error(), flags_start);
  1341. else
  1342. parsed_flags = parsed_flags_or_error.release_value();
  1343. }
  1344. String parsed_pattern;
  1345. auto parsed_pattern_result = parse_regex_pattern(pattern, parsed_flags.has_flag_set(ECMAScriptFlags::Unicode), parsed_flags.has_flag_set(ECMAScriptFlags::UnicodeSets));
  1346. if (parsed_pattern_result.is_error()) {
  1347. syntax_error(parsed_pattern_result.release_error().error, rule_start.position());
  1348. parsed_pattern = String::empty();
  1349. } else {
  1350. parsed_pattern = parsed_pattern_result.release_value();
  1351. }
  1352. auto parsed_regex = Regex<ECMA262>::parse_pattern(parsed_pattern, parsed_flags);
  1353. if (parsed_regex.error != regex::Error::NoError)
  1354. syntax_error(String::formatted("RegExp compile error: {}", Regex<ECMA262>(parsed_regex, parsed_pattern, parsed_flags).error_string()), rule_start.position());
  1355. SourceRange range { m_source_code, rule_start.position(), position() };
  1356. return create_ast_node<RegExpLiteral>(move(range), move(parsed_regex), move(parsed_pattern), move(parsed_flags), pattern.to_string(), move(flags));
  1357. }
  1358. NonnullRefPtr<Expression> Parser::parse_unary_prefixed_expression()
  1359. {
  1360. auto rule_start = push_start();
  1361. auto precedence = g_operator_precedence.get(m_state.current_token.type());
  1362. auto associativity = operator_associativity(m_state.current_token.type());
  1363. switch (m_state.current_token.type()) {
  1364. case TokenType::PlusPlus: {
  1365. consume();
  1366. auto rhs_start = position();
  1367. auto rhs = parse_expression(precedence, associativity);
  1368. // FIXME: Apparently for functions this should also not be enforced on a parser level,
  1369. // other engines throw ReferenceError for ++foo()
  1370. if (!is<Identifier>(*rhs) && !is<MemberExpression>(*rhs))
  1371. syntax_error(String::formatted("Right-hand side of prefix increment operator must be identifier or member expression, got {}", rhs->class_name()), rhs_start);
  1372. if (m_state.strict_mode && is<Identifier>(*rhs)) {
  1373. auto& identifier = static_cast<Identifier&>(*rhs);
  1374. auto& name = identifier.string();
  1375. check_identifier_name_for_assignment_validity(name);
  1376. }
  1377. return create_ast_node<UpdateExpression>({ m_source_code, rule_start.position(), position() }, UpdateOp::Increment, move(rhs), true);
  1378. }
  1379. case TokenType::MinusMinus: {
  1380. consume();
  1381. auto rhs_start = position();
  1382. auto rhs = parse_expression(precedence, associativity);
  1383. // FIXME: Apparently for functions this should also not be enforced on a parser level,
  1384. // other engines throw ReferenceError for --foo()
  1385. if (!is<Identifier>(*rhs) && !is<MemberExpression>(*rhs))
  1386. syntax_error(String::formatted("Right-hand side of prefix decrement operator must be identifier or member expression, got {}", rhs->class_name()), rhs_start);
  1387. if (m_state.strict_mode && is<Identifier>(*rhs)) {
  1388. auto& identifier = static_cast<Identifier&>(*rhs);
  1389. auto& name = identifier.string();
  1390. check_identifier_name_for_assignment_validity(name);
  1391. }
  1392. return create_ast_node<UpdateExpression>({ m_source_code, rule_start.position(), position() }, UpdateOp::Decrement, move(rhs), true);
  1393. }
  1394. case TokenType::ExclamationMark:
  1395. consume();
  1396. return create_ast_node<UnaryExpression>({ m_source_code, rule_start.position(), position() }, UnaryOp::Not, parse_expression(precedence, associativity));
  1397. case TokenType::Tilde:
  1398. consume();
  1399. return create_ast_node<UnaryExpression>({ m_source_code, rule_start.position(), position() }, UnaryOp::BitwiseNot, parse_expression(precedence, associativity));
  1400. case TokenType::Plus:
  1401. consume();
  1402. return create_ast_node<UnaryExpression>({ m_source_code, rule_start.position(), position() }, UnaryOp::Plus, parse_expression(precedence, associativity));
  1403. case TokenType::Minus:
  1404. consume();
  1405. return create_ast_node<UnaryExpression>({ m_source_code, rule_start.position(), position() }, UnaryOp::Minus, parse_expression(precedence, associativity));
  1406. case TokenType::Typeof:
  1407. consume();
  1408. return create_ast_node<UnaryExpression>({ m_source_code, rule_start.position(), position() }, UnaryOp::Typeof, parse_expression(precedence, associativity));
  1409. case TokenType::Void:
  1410. consume();
  1411. // FIXME: This check is really hiding the fact that we don't deal with different expressions correctly.
  1412. if (match(TokenType::Yield) && m_state.in_generator_function_context)
  1413. syntax_error("'yield' is not an identifier in generator function context");
  1414. return create_ast_node<UnaryExpression>({ m_source_code, rule_start.position(), position() }, UnaryOp::Void, parse_expression(precedence, associativity));
  1415. case TokenType::Delete: {
  1416. consume();
  1417. auto rhs_start = position();
  1418. auto rhs = parse_expression(precedence, associativity);
  1419. if (is<Identifier>(*rhs) && m_state.strict_mode) {
  1420. syntax_error("Delete of an unqualified identifier in strict mode.", rhs_start);
  1421. }
  1422. if (is<MemberExpression>(*rhs)) {
  1423. auto& member_expression = static_cast<MemberExpression const&>(*rhs);
  1424. if (member_expression.ends_in_private_name())
  1425. syntax_error("Private fields cannot be deleted");
  1426. }
  1427. return create_ast_node<UnaryExpression>({ m_source_code, rule_start.position(), position() }, UnaryOp::Delete, move(rhs));
  1428. }
  1429. default:
  1430. expected("primary expression");
  1431. consume();
  1432. return create_ast_node<ErrorExpression>({ m_source_code, rule_start.position(), position() });
  1433. }
  1434. }
  1435. NonnullRefPtr<Expression> Parser::parse_property_key()
  1436. {
  1437. auto rule_start = push_start();
  1438. if (match(TokenType::StringLiteral)) {
  1439. return parse_string_literal(consume());
  1440. } else if (match(TokenType::NumericLiteral)) {
  1441. return create_ast_node<NumericLiteral>({ m_source_code, rule_start.position(), position() }, consume().double_value());
  1442. } else if (match(TokenType::BigIntLiteral)) {
  1443. return create_ast_node<BigIntLiteral>({ m_source_code, rule_start.position(), position() }, consume().value());
  1444. } else if (match(TokenType::BracketOpen)) {
  1445. consume(TokenType::BracketOpen);
  1446. auto result = parse_expression(2);
  1447. consume(TokenType::BracketClose);
  1448. return result;
  1449. } else {
  1450. if (!match_identifier_name())
  1451. expected("IdentifierName");
  1452. return create_ast_node<StringLiteral>({ m_source_code, rule_start.position(), position() }, consume().value());
  1453. }
  1454. }
  1455. NonnullRefPtr<ObjectExpression> Parser::parse_object_expression()
  1456. {
  1457. auto rule_start = push_start();
  1458. consume(TokenType::CurlyOpen);
  1459. NonnullRefPtrVector<ObjectProperty> properties;
  1460. ObjectProperty::Type property_type;
  1461. Optional<SourceRange> invalid_object_literal_property_range;
  1462. auto skip_to_next_property = [&] {
  1463. while (!done() && !match(TokenType::Comma) && !match(TokenType::CurlyOpen))
  1464. consume();
  1465. };
  1466. // It is a Syntax Error if PropertyNameList of PropertyDefinitionList contains any duplicate
  1467. // entries for "__proto__" and at least two of those entries were obtained from productions of
  1468. // the form PropertyDefinition : PropertyKey : AssignmentExpression .
  1469. bool has_direct_proto_property = false;
  1470. while (!done() && !match(TokenType::CurlyClose)) {
  1471. property_type = ObjectProperty::Type::KeyValue;
  1472. RefPtr<Expression> property_key;
  1473. RefPtr<Expression> property_value;
  1474. FunctionKind function_kind { FunctionKind::Normal };
  1475. if (match(TokenType::TripleDot)) {
  1476. consume();
  1477. property_key = parse_expression(4);
  1478. properties.append(create_ast_node<ObjectProperty>({ m_source_code, rule_start.position(), position() }, *property_key, nullptr, ObjectProperty::Type::Spread, false));
  1479. if (!match(TokenType::Comma))
  1480. break;
  1481. consume(TokenType::Comma);
  1482. continue;
  1483. }
  1484. auto type = m_state.current_token.type();
  1485. auto function_start = position();
  1486. if (match(TokenType::Async)) {
  1487. auto lookahead_token = next_token();
  1488. if (lookahead_token.type() != TokenType::ParenOpen && lookahead_token.type() != TokenType::Colon
  1489. && lookahead_token.type() != TokenType::Comma && lookahead_token.type() != TokenType::CurlyClose
  1490. && lookahead_token.type() != TokenType::Async
  1491. && !lookahead_token.trivia_contains_line_terminator()) {
  1492. consume(TokenType::Async);
  1493. function_kind = FunctionKind::Async;
  1494. }
  1495. }
  1496. if (match(TokenType::Asterisk)) {
  1497. consume();
  1498. property_type = ObjectProperty::Type::KeyValue;
  1499. property_key = parse_property_key();
  1500. VERIFY(function_kind == FunctionKind::Normal || function_kind == FunctionKind::Async);
  1501. function_kind = function_kind == FunctionKind::Normal ? FunctionKind::Generator : FunctionKind::AsyncGenerator;
  1502. } else if (match_identifier()) {
  1503. auto identifier = consume();
  1504. if (identifier.original_value() == "get"sv && match_property_key()) {
  1505. property_type = ObjectProperty::Type::Getter;
  1506. property_key = parse_property_key();
  1507. } else if (identifier.original_value() == "set"sv && match_property_key()) {
  1508. property_type = ObjectProperty::Type::Setter;
  1509. property_key = parse_property_key();
  1510. } else {
  1511. property_key = create_ast_node<StringLiteral>({ m_source_code, rule_start.position(), position() }, identifier.value());
  1512. property_value = create_ast_node<Identifier>({ m_source_code, rule_start.position(), position() }, identifier.flystring_value());
  1513. }
  1514. } else {
  1515. property_key = parse_property_key();
  1516. }
  1517. // 4. Else if propKey is the String value "__proto__" and if IsComputedPropertyKey of PropertyName is false, then
  1518. // a. Let isProtoSetter be true.
  1519. bool is_proto = (type == TokenType::StringLiteral || type == TokenType::Identifier) && is<StringLiteral>(*property_key) && static_cast<StringLiteral const&>(*property_key).value() == "__proto__";
  1520. if (property_type == ObjectProperty::Type::Getter || property_type == ObjectProperty::Type::Setter) {
  1521. if (!match(TokenType::ParenOpen)) {
  1522. expected("'(' for object getter or setter property");
  1523. skip_to_next_property();
  1524. continue;
  1525. }
  1526. }
  1527. if (match(TokenType::Equals)) {
  1528. // Not a valid object literal, but a valid assignment target
  1529. consume();
  1530. // Parse the expression and throw it away
  1531. auto expression = parse_expression(2);
  1532. if (!invalid_object_literal_property_range.has_value())
  1533. invalid_object_literal_property_range = expression->source_range();
  1534. } else if (match(TokenType::ParenOpen)) {
  1535. VERIFY(property_key);
  1536. u8 parse_options = FunctionNodeParseOptions::AllowSuperPropertyLookup;
  1537. if (property_type == ObjectProperty::Type::Getter)
  1538. parse_options |= FunctionNodeParseOptions::IsGetterFunction;
  1539. if (property_type == ObjectProperty::Type::Setter)
  1540. parse_options |= FunctionNodeParseOptions::IsSetterFunction;
  1541. if (function_kind == FunctionKind::Generator || function_kind == FunctionKind::AsyncGenerator)
  1542. parse_options |= FunctionNodeParseOptions::IsGeneratorFunction;
  1543. if (function_kind == FunctionKind::Async || function_kind == FunctionKind::AsyncGenerator)
  1544. parse_options |= FunctionNodeParseOptions::IsAsyncFunction;
  1545. auto function = parse_function_node<FunctionExpression>(parse_options, function_start);
  1546. properties.append(create_ast_node<ObjectProperty>({ m_source_code, rule_start.position(), position() }, *property_key, function, property_type, true));
  1547. } else if (match(TokenType::Colon)) {
  1548. if (!property_key) {
  1549. expected("a property name");
  1550. skip_to_next_property();
  1551. continue;
  1552. }
  1553. consume();
  1554. if (is_proto) {
  1555. if (has_direct_proto_property)
  1556. syntax_error("Property name '__proto__' must not appear more than once in object literal");
  1557. has_direct_proto_property = true;
  1558. }
  1559. if (is_proto && property_type == ObjectProperty::Type::KeyValue)
  1560. property_type = ObjectProperty::Type::ProtoSetter;
  1561. properties.append(create_ast_node<ObjectProperty>({ m_source_code, rule_start.position(), position() }, *property_key, parse_expression(2), property_type, false));
  1562. } else if (property_key && property_value) {
  1563. if (m_state.strict_mode && is<StringLiteral>(*property_key)) {
  1564. auto& string_literal = static_cast<StringLiteral const&>(*property_key);
  1565. if (is_strict_reserved_word(string_literal.value()))
  1566. syntax_error(String::formatted("'{}' is a reserved keyword", string_literal.value()));
  1567. }
  1568. properties.append(create_ast_node<ObjectProperty>({ m_source_code, rule_start.position(), position() }, *property_key, *property_value, property_type, false));
  1569. } else {
  1570. expected("a property");
  1571. skip_to_next_property();
  1572. continue;
  1573. }
  1574. if (!match(TokenType::Comma))
  1575. break;
  1576. consume(TokenType::Comma);
  1577. }
  1578. consume(TokenType::CurlyClose);
  1579. return create_ast_node<ObjectExpression>(
  1580. { m_source_code, rule_start.position(), position() },
  1581. move(properties),
  1582. move(invalid_object_literal_property_range));
  1583. }
  1584. NonnullRefPtr<ArrayExpression> Parser::parse_array_expression()
  1585. {
  1586. auto rule_start = push_start();
  1587. consume(TokenType::BracketOpen);
  1588. Vector<RefPtr<Expression>> elements;
  1589. while (match_expression() || match(TokenType::TripleDot) || match(TokenType::Comma)) {
  1590. RefPtr<Expression> expression;
  1591. if (match(TokenType::TripleDot)) {
  1592. consume(TokenType::TripleDot);
  1593. expression = create_ast_node<SpreadExpression>({ m_source_code, rule_start.position(), position() }, parse_expression(2));
  1594. } else if (match_expression()) {
  1595. expression = parse_expression(2);
  1596. }
  1597. elements.append(expression);
  1598. if (!match(TokenType::Comma))
  1599. break;
  1600. consume(TokenType::Comma);
  1601. }
  1602. consume(TokenType::BracketClose);
  1603. return create_ast_node<ArrayExpression>({ m_source_code, rule_start.position(), position() }, move(elements));
  1604. }
  1605. NonnullRefPtr<StringLiteral> Parser::parse_string_literal(Token const& token, StringLiteralType string_literal_type, bool* contains_invalid_escape)
  1606. {
  1607. auto rule_start = push_start();
  1608. auto status = Token::StringValueStatus::Ok;
  1609. auto string = token.string_value(status);
  1610. // NOTE: Tagged templates should not fail on invalid strings as their raw contents can still be accessed.
  1611. if (status != Token::StringValueStatus::Ok) {
  1612. String message;
  1613. if (status == Token::StringValueStatus::LegacyOctalEscapeSequence) {
  1614. m_state.string_legacy_octal_escape_sequence_in_scope = true;
  1615. // It is a Syntax Error if the [Tagged] parameter was not set and Template{Head, Middle, Tail} Contains NotEscapeSequence.
  1616. if (string_literal_type != StringLiteralType::Normal)
  1617. message = "Octal escape sequence not allowed in template literal";
  1618. else if (m_state.strict_mode)
  1619. message = "Octal escape sequence in string literal not allowed in strict mode";
  1620. } else if (status == Token::StringValueStatus::MalformedHexEscape || status == Token::StringValueStatus::MalformedUnicodeEscape) {
  1621. auto type = status == Token::StringValueStatus::MalformedUnicodeEscape ? "unicode" : "hexadecimal";
  1622. message = String::formatted("Malformed {} escape sequence", type);
  1623. } else if (status == Token::StringValueStatus::UnicodeEscapeOverflow) {
  1624. message = "Unicode code_point must not be greater than 0x10ffff in escape sequence";
  1625. } else {
  1626. VERIFY_NOT_REACHED();
  1627. }
  1628. if (!message.is_empty()) {
  1629. if (contains_invalid_escape != nullptr) {
  1630. VERIFY(string_literal_type == StringLiteralType::TaggedTemplate);
  1631. *contains_invalid_escape = true;
  1632. } else {
  1633. syntax_error(message, Position { token.line_number(), token.line_column() });
  1634. }
  1635. }
  1636. }
  1637. auto is_use_strict_directive = string_literal_type == StringLiteralType::Normal && (token.value() == "'use strict'" || token.value() == "\"use strict\"");
  1638. return create_ast_node<StringLiteral>({ m_source_code, rule_start.position(), position() }, string, is_use_strict_directive);
  1639. }
  1640. NonnullRefPtr<TemplateLiteral> Parser::parse_template_literal(bool is_tagged)
  1641. {
  1642. auto rule_start = push_start();
  1643. consume(TokenType::TemplateLiteralStart);
  1644. NonnullRefPtrVector<Expression> expressions;
  1645. NonnullRefPtrVector<Expression> raw_strings;
  1646. auto append_empty_string = [this, &rule_start, &expressions, &raw_strings, is_tagged]() {
  1647. auto string_literal = create_ast_node<StringLiteral>({ m_source_code, rule_start.position(), position() }, "");
  1648. expressions.append(string_literal);
  1649. if (is_tagged)
  1650. raw_strings.append(string_literal);
  1651. };
  1652. if (!match(TokenType::TemplateLiteralString))
  1653. append_empty_string();
  1654. while (!done() && !match(TokenType::TemplateLiteralEnd) && !match(TokenType::UnterminatedTemplateLiteral)) {
  1655. if (match(TokenType::TemplateLiteralString)) {
  1656. auto token = consume();
  1657. bool contains_invalid_escape = false;
  1658. auto parsed_string_value = parse_string_literal(token,
  1659. is_tagged ? StringLiteralType::TaggedTemplate : StringLiteralType::NonTaggedTemplate,
  1660. is_tagged ? &contains_invalid_escape : nullptr);
  1661. // An invalid string leads to a cooked value of `undefined` but still gives the raw string.
  1662. if (contains_invalid_escape)
  1663. expressions.append(create_ast_node<NullLiteral>({ m_source_code, rule_start.position(), position() }));
  1664. else
  1665. expressions.append(move(parsed_string_value));
  1666. if (is_tagged)
  1667. raw_strings.append(create_ast_node<StringLiteral>({ m_source_code, rule_start.position(), position() }, token.raw_template_value()));
  1668. } else if (match(TokenType::TemplateLiteralExprStart)) {
  1669. consume(TokenType::TemplateLiteralExprStart);
  1670. if (match(TokenType::TemplateLiteralExprEnd)) {
  1671. syntax_error("Empty template literal expression block");
  1672. return create_ast_node<TemplateLiteral>({ m_source_code, rule_start.position(), position() }, expressions);
  1673. }
  1674. expressions.append(parse_expression(0));
  1675. if (match(TokenType::UnterminatedTemplateLiteral)) {
  1676. syntax_error("Unterminated template literal");
  1677. return create_ast_node<TemplateLiteral>({ m_source_code, rule_start.position(), position() }, expressions);
  1678. }
  1679. consume(TokenType::TemplateLiteralExprEnd);
  1680. if (!match(TokenType::TemplateLiteralString))
  1681. append_empty_string();
  1682. } else {
  1683. expected("Template literal string or expression");
  1684. break;
  1685. }
  1686. }
  1687. if (match(TokenType::UnterminatedTemplateLiteral)) {
  1688. syntax_error("Unterminated template literal");
  1689. } else {
  1690. consume(TokenType::TemplateLiteralEnd);
  1691. }
  1692. if (is_tagged)
  1693. return create_ast_node<TemplateLiteral>({ m_source_code, rule_start.position(), position() }, expressions, raw_strings);
  1694. return create_ast_node<TemplateLiteral>({ m_source_code, rule_start.position(), position() }, expressions);
  1695. }
  1696. NonnullRefPtr<Expression> Parser::parse_expression(int min_precedence, Associativity associativity, ForbiddenTokens forbidden)
  1697. {
  1698. auto rule_start = push_start();
  1699. auto [expression, should_continue_parsing] = parse_primary_expression();
  1700. auto check_for_invalid_object_property = [&](auto& expression) {
  1701. if (is<ObjectExpression>(*expression)) {
  1702. if (auto range = static_cast<ObjectExpression&>(*expression).invalid_property_range(); range.has_value())
  1703. syntax_error("Invalid property in object literal", range->start);
  1704. }
  1705. };
  1706. if (is<Identifier>(*expression) && m_state.current_scope_pusher) {
  1707. auto identifier_instance = static_ptr_cast<Identifier>(expression);
  1708. auto function_scope = m_state.current_scope_pusher->last_function_scope();
  1709. auto function_parent_scope = function_scope ? function_scope->parent_scope() : nullptr;
  1710. bool has_not_been_declared_as_variable = true;
  1711. for (auto scope = m_state.current_scope_pusher; scope != function_parent_scope; scope = scope->parent_scope()) {
  1712. if (scope->has_declaration(identifier_instance->string())) {
  1713. has_not_been_declared_as_variable = false;
  1714. break;
  1715. }
  1716. }
  1717. if (has_not_been_declared_as_variable) {
  1718. if (identifier_instance->string() == "arguments"sv)
  1719. m_state.current_scope_pusher->set_contains_access_to_arguments_object();
  1720. }
  1721. }
  1722. while (match(TokenType::TemplateLiteralStart)) {
  1723. auto template_literal = parse_template_literal(true);
  1724. expression = create_ast_node<TaggedTemplateLiteral>({ m_source_code, rule_start.position(), position() }, move(expression), move(template_literal));
  1725. }
  1726. if (should_continue_parsing) {
  1727. while (match_secondary_expression(forbidden)) {
  1728. int new_precedence = g_operator_precedence.get(m_state.current_token.type());
  1729. if (new_precedence < min_precedence)
  1730. break;
  1731. if (new_precedence == min_precedence && associativity == Associativity::Left)
  1732. break;
  1733. check_for_invalid_object_property(expression);
  1734. Associativity new_associativity = operator_associativity(m_state.current_token.type());
  1735. auto result = parse_secondary_expression(move(expression), new_precedence, new_associativity, forbidden);
  1736. expression = result.expression;
  1737. forbidden = forbidden.merge(result.forbidden);
  1738. while (match(TokenType::TemplateLiteralStart) && !is<UpdateExpression>(*expression)) {
  1739. auto template_literal = parse_template_literal(true);
  1740. expression = create_ast_node<TaggedTemplateLiteral>({ m_source_code, rule_start.position(), position() }, move(expression), move(template_literal));
  1741. }
  1742. }
  1743. }
  1744. if (is<SuperExpression>(*expression))
  1745. syntax_error("'super' keyword unexpected here");
  1746. check_for_invalid_object_property(expression);
  1747. if (is<CallExpression>(*expression) && m_state.current_scope_pusher) {
  1748. auto& callee = static_ptr_cast<CallExpression>(expression)->callee();
  1749. if (is<Identifier>(callee)) {
  1750. auto& identifier_instance = static_cast<Identifier const&>(callee);
  1751. if (identifier_instance.string() == "eval"sv) {
  1752. bool has_not_been_declared_as_variable = true;
  1753. for (auto scope = m_state.current_scope_pusher; scope; scope = scope->parent_scope()) {
  1754. if (scope->has_declaration(identifier_instance.string())) {
  1755. has_not_been_declared_as_variable = false;
  1756. break;
  1757. }
  1758. }
  1759. if (has_not_been_declared_as_variable)
  1760. m_state.current_scope_pusher->set_contains_direct_call_to_eval();
  1761. }
  1762. }
  1763. }
  1764. if (match(TokenType::Comma) && min_precedence <= 1) {
  1765. NonnullRefPtrVector<Expression> expressions;
  1766. expressions.append(expression);
  1767. while (match(TokenType::Comma)) {
  1768. consume();
  1769. expressions.append(parse_expression(2));
  1770. }
  1771. expression = create_ast_node<SequenceExpression>({ m_source_code, rule_start.position(), position() }, move(expressions));
  1772. }
  1773. return expression;
  1774. }
  1775. Parser::ExpressionResult Parser::parse_secondary_expression(NonnullRefPtr<Expression> lhs, int min_precedence, Associativity associativity, ForbiddenTokens forbidden)
  1776. {
  1777. auto rule_start = push_start();
  1778. switch (m_state.current_token.type()) {
  1779. case TokenType::Plus:
  1780. consume();
  1781. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::Addition, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1782. case TokenType::PlusEquals:
  1783. return parse_assignment_expression(AssignmentOp::AdditionAssignment, move(lhs), min_precedence, associativity, forbidden);
  1784. case TokenType::Minus:
  1785. consume();
  1786. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::Subtraction, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1787. case TokenType::MinusEquals:
  1788. return parse_assignment_expression(AssignmentOp::SubtractionAssignment, move(lhs), min_precedence, associativity, forbidden);
  1789. case TokenType::Asterisk:
  1790. consume();
  1791. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::Multiplication, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1792. case TokenType::AsteriskEquals:
  1793. return parse_assignment_expression(AssignmentOp::MultiplicationAssignment, move(lhs), min_precedence, associativity, forbidden);
  1794. case TokenType::Slash:
  1795. consume();
  1796. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::Division, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1797. case TokenType::SlashEquals:
  1798. return parse_assignment_expression(AssignmentOp::DivisionAssignment, move(lhs), min_precedence, associativity, forbidden);
  1799. case TokenType::Percent:
  1800. consume();
  1801. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::Modulo, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1802. case TokenType::PercentEquals:
  1803. return parse_assignment_expression(AssignmentOp::ModuloAssignment, move(lhs), min_precedence, associativity, forbidden);
  1804. case TokenType::DoubleAsterisk:
  1805. consume();
  1806. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::Exponentiation, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1807. case TokenType::DoubleAsteriskEquals:
  1808. return parse_assignment_expression(AssignmentOp::ExponentiationAssignment, move(lhs), min_precedence, associativity, forbidden);
  1809. case TokenType::GreaterThan:
  1810. consume();
  1811. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::GreaterThan, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1812. case TokenType::GreaterThanEquals:
  1813. consume();
  1814. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::GreaterThanEquals, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1815. case TokenType::LessThan:
  1816. consume();
  1817. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::LessThan, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1818. case TokenType::LessThanEquals:
  1819. consume();
  1820. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::LessThanEquals, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1821. case TokenType::EqualsEqualsEquals:
  1822. consume();
  1823. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::StrictlyEquals, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1824. case TokenType::ExclamationMarkEqualsEquals:
  1825. consume();
  1826. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::StrictlyInequals, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1827. case TokenType::EqualsEquals:
  1828. consume();
  1829. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::LooselyEquals, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1830. case TokenType::ExclamationMarkEquals:
  1831. consume();
  1832. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::LooselyInequals, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1833. case TokenType::In:
  1834. consume();
  1835. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::In, move(lhs), parse_expression(min_precedence, associativity));
  1836. case TokenType::Instanceof:
  1837. consume();
  1838. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::InstanceOf, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1839. case TokenType::Ampersand:
  1840. consume();
  1841. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::BitwiseAnd, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1842. case TokenType::AmpersandEquals:
  1843. return parse_assignment_expression(AssignmentOp::BitwiseAndAssignment, move(lhs), min_precedence, associativity, forbidden);
  1844. case TokenType::Pipe:
  1845. consume();
  1846. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::BitwiseOr, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1847. case TokenType::PipeEquals:
  1848. return parse_assignment_expression(AssignmentOp::BitwiseOrAssignment, move(lhs), min_precedence, associativity, forbidden);
  1849. case TokenType::Caret:
  1850. consume();
  1851. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::BitwiseXor, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1852. case TokenType::CaretEquals:
  1853. return parse_assignment_expression(AssignmentOp::BitwiseXorAssignment, move(lhs), min_precedence, associativity, forbidden);
  1854. case TokenType::ShiftLeft:
  1855. consume();
  1856. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::LeftShift, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1857. case TokenType::ShiftLeftEquals:
  1858. return parse_assignment_expression(AssignmentOp::LeftShiftAssignment, move(lhs), min_precedence, associativity, forbidden);
  1859. case TokenType::ShiftRight:
  1860. consume();
  1861. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::RightShift, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1862. case TokenType::ShiftRightEquals:
  1863. return parse_assignment_expression(AssignmentOp::RightShiftAssignment, move(lhs), min_precedence, associativity, forbidden);
  1864. case TokenType::UnsignedShiftRight:
  1865. consume();
  1866. return create_ast_node<BinaryExpression>({ m_source_code, rule_start.position(), position() }, BinaryOp::UnsignedRightShift, move(lhs), parse_expression(min_precedence, associativity, forbidden));
  1867. case TokenType::UnsignedShiftRightEquals:
  1868. return parse_assignment_expression(AssignmentOp::UnsignedRightShiftAssignment, move(lhs), min_precedence, associativity, forbidden);
  1869. case TokenType::ParenOpen:
  1870. return parse_call_expression(move(lhs));
  1871. case TokenType::Equals:
  1872. return parse_assignment_expression(AssignmentOp::Assignment, move(lhs), min_precedence, associativity, forbidden);
  1873. case TokenType::Period:
  1874. consume();
  1875. if (match(TokenType::PrivateIdentifier)) {
  1876. if (!is_private_identifier_valid())
  1877. syntax_error(String::formatted("Reference to undeclared private field or method '{}'", m_state.current_token.value()));
  1878. else if (is<SuperExpression>(*lhs))
  1879. syntax_error(String::formatted("Cannot access private field or method '{}' on super", m_state.current_token.value()));
  1880. return create_ast_node<MemberExpression>({ m_source_code, rule_start.position(), position() }, move(lhs), create_ast_node<PrivateIdentifier>({ m_source_code, rule_start.position(), position() }, consume().value()));
  1881. } else if (!match_identifier_name()) {
  1882. expected("IdentifierName");
  1883. }
  1884. return create_ast_node<MemberExpression>({ m_source_code, rule_start.position(), position() }, move(lhs), create_ast_node<Identifier>({ m_source_code, rule_start.position(), position() }, consume().flystring_value()));
  1885. case TokenType::BracketOpen: {
  1886. consume(TokenType::BracketOpen);
  1887. auto expression = create_ast_node<MemberExpression>({ m_source_code, rule_start.position(), position() }, move(lhs), parse_expression(0), true);
  1888. consume(TokenType::BracketClose);
  1889. return expression;
  1890. }
  1891. case TokenType::PlusPlus:
  1892. // FIXME: Apparently for functions this should also not be enforced on a parser level,
  1893. // other engines throw ReferenceError for foo()++
  1894. if (!is<Identifier>(*lhs) && !is<MemberExpression>(*lhs))
  1895. syntax_error(String::formatted("Left-hand side of postfix increment operator must be identifier or member expression, got {}", lhs->class_name()));
  1896. if (m_state.strict_mode && is<Identifier>(*lhs)) {
  1897. auto& identifier = static_cast<Identifier&>(*lhs);
  1898. auto& name = identifier.string();
  1899. check_identifier_name_for_assignment_validity(name);
  1900. }
  1901. consume();
  1902. return create_ast_node<UpdateExpression>({ m_source_code, rule_start.position(), position() }, UpdateOp::Increment, move(lhs));
  1903. case TokenType::MinusMinus:
  1904. // FIXME: Apparently for functions this should also not be enforced on a parser level,
  1905. // other engines throw ReferenceError for foo()--
  1906. if (!is<Identifier>(*lhs) && !is<MemberExpression>(*lhs))
  1907. syntax_error(String::formatted("Left-hand side of postfix increment operator must be identifier or member expression, got {}", lhs->class_name()));
  1908. if (m_state.strict_mode && is<Identifier>(*lhs)) {
  1909. auto& identifier = static_cast<Identifier&>(*lhs);
  1910. auto& name = identifier.string();
  1911. check_identifier_name_for_assignment_validity(name);
  1912. }
  1913. consume();
  1914. return create_ast_node<UpdateExpression>({ m_source_code, rule_start.position(), position() }, UpdateOp::Decrement, move(lhs));
  1915. case TokenType::DoubleAmpersand: {
  1916. consume();
  1917. auto expression = create_ast_node<LogicalExpression>({ m_source_code, rule_start.position(), position() }, LogicalOp::And, move(lhs), parse_expression(min_precedence, associativity, forbidden.forbid({ TokenType::DoubleQuestionMark })));
  1918. return { expression, { TokenType::DoubleQuestionMark } };
  1919. }
  1920. case TokenType::DoubleAmpersandEquals:
  1921. return parse_assignment_expression(AssignmentOp::AndAssignment, move(lhs), min_precedence, associativity, forbidden);
  1922. case TokenType::DoublePipe: {
  1923. consume();
  1924. auto expression = create_ast_node<LogicalExpression>({ m_source_code, rule_start.position(), position() }, LogicalOp::Or, move(lhs), parse_expression(min_precedence, associativity, forbidden.forbid({ TokenType::DoubleQuestionMark })));
  1925. return { expression, { TokenType::DoubleQuestionMark } };
  1926. }
  1927. case TokenType::DoublePipeEquals:
  1928. return parse_assignment_expression(AssignmentOp::OrAssignment, move(lhs), min_precedence, associativity, forbidden);
  1929. case TokenType::DoubleQuestionMark: {
  1930. consume();
  1931. auto expression = create_ast_node<LogicalExpression>({ m_source_code, rule_start.position(), position() }, LogicalOp::NullishCoalescing, move(lhs), parse_expression(min_precedence, associativity, forbidden.forbid({ TokenType::DoubleAmpersand, TokenType::DoublePipe })));
  1932. return { expression, { TokenType::DoubleAmpersand, TokenType::DoublePipe } };
  1933. }
  1934. case TokenType::DoubleQuestionMarkEquals:
  1935. return parse_assignment_expression(AssignmentOp::NullishAssignment, move(lhs), min_precedence, associativity, forbidden);
  1936. case TokenType::QuestionMark:
  1937. return parse_conditional_expression(move(lhs), forbidden);
  1938. case TokenType::QuestionMarkPeriod:
  1939. // FIXME: This should allow `(new Foo)?.bar', but as our parser strips parenthesis,
  1940. // we can't really tell if `lhs' was parenthesized at this point.
  1941. if (is<NewExpression>(lhs.ptr())) {
  1942. syntax_error("'new' cannot be used with optional chaining", position());
  1943. consume();
  1944. return lhs;
  1945. }
  1946. return parse_optional_chain(move(lhs));
  1947. default:
  1948. expected("secondary expression");
  1949. consume();
  1950. return create_ast_node<ErrorExpression>({ m_source_code, rule_start.position(), position() });
  1951. }
  1952. }
  1953. bool Parser::is_private_identifier_valid() const
  1954. {
  1955. VERIFY(match(TokenType::PrivateIdentifier));
  1956. if (!m_state.referenced_private_names)
  1957. return false;
  1958. // We might not have hit the declaration yet so class will check this in the end
  1959. m_state.referenced_private_names->set(m_state.current_token.value());
  1960. return true;
  1961. }
  1962. RefPtr<BindingPattern> Parser::synthesize_binding_pattern(Expression const& expression)
  1963. {
  1964. VERIFY(is<ArrayExpression>(expression) || is<ObjectExpression>(expression));
  1965. // Clear any syntax error that has occurred in the range that 'expression' spans.
  1966. m_state.errors.remove_all_matching([range = expression.source_range()](auto const& error) {
  1967. return error.position.has_value() && range.contains(*error.position);
  1968. });
  1969. // Make a parser and parse the source for this expression as a binding pattern.
  1970. // NOTE: There's currently a fundamental problem that we pass the *next* (a.k.a. `current_token`)
  1971. // token's position to most nodes' SourceRange when using `rule_start.position(), position()`.
  1972. // This means that `source` will contain the subsequent token's trivia, if any (which is fine).
  1973. auto source_start_offset = expression.source_range().start.offset;
  1974. auto source_end_offset = expression.source_range().end.offset;
  1975. auto source = m_state.lexer.source().substring_view(source_start_offset, source_end_offset - source_start_offset);
  1976. Lexer lexer { source, m_state.lexer.filename(), expression.source_range().start.line, expression.source_range().start.column };
  1977. Parser parser { lexer };
  1978. parser.m_state.strict_mode = m_state.strict_mode;
  1979. parser.m_state.allow_super_property_lookup = m_state.allow_super_property_lookup;
  1980. parser.m_state.allow_super_constructor_call = m_state.allow_super_constructor_call;
  1981. parser.m_state.in_function_context = m_state.in_function_context;
  1982. parser.m_state.in_formal_parameter_context = m_state.in_formal_parameter_context;
  1983. parser.m_state.in_generator_function_context = m_state.in_generator_function_context;
  1984. parser.m_state.await_expression_is_valid = m_state.await_expression_is_valid;
  1985. parser.m_state.in_arrow_function_context = m_state.in_arrow_function_context;
  1986. parser.m_state.in_break_context = m_state.in_break_context;
  1987. parser.m_state.in_continue_context = m_state.in_continue_context;
  1988. parser.m_state.string_legacy_octal_escape_sequence_in_scope = m_state.string_legacy_octal_escape_sequence_in_scope;
  1989. parser.m_state.in_class_field_initializer = m_state.in_class_field_initializer;
  1990. parser.m_state.in_class_static_init_block = m_state.in_class_static_init_block;
  1991. parser.m_state.referenced_private_names = m_state.referenced_private_names;
  1992. auto result = parser.parse_binding_pattern(AllowDuplicates::Yes, AllowMemberExpressions::Yes);
  1993. if (parser.has_errors())
  1994. m_state.errors.extend(parser.errors());
  1995. return result;
  1996. }
  1997. NonnullRefPtr<AssignmentExpression> Parser::parse_assignment_expression(AssignmentOp assignment_op, NonnullRefPtr<Expression> lhs, int min_precedence, Associativity associativity, ForbiddenTokens forbidden)
  1998. {
  1999. auto rule_start = push_start();
  2000. VERIFY(match(TokenType::Equals)
  2001. || match(TokenType::PlusEquals)
  2002. || match(TokenType::MinusEquals)
  2003. || match(TokenType::AsteriskEquals)
  2004. || match(TokenType::SlashEquals)
  2005. || match(TokenType::PercentEquals)
  2006. || match(TokenType::DoubleAsteriskEquals)
  2007. || match(TokenType::AmpersandEquals)
  2008. || match(TokenType::PipeEquals)
  2009. || match(TokenType::CaretEquals)
  2010. || match(TokenType::ShiftLeftEquals)
  2011. || match(TokenType::ShiftRightEquals)
  2012. || match(TokenType::UnsignedShiftRightEquals)
  2013. || match(TokenType::DoubleAmpersandEquals)
  2014. || match(TokenType::DoublePipeEquals)
  2015. || match(TokenType::DoubleQuestionMarkEquals));
  2016. consume();
  2017. if (assignment_op == AssignmentOp::Assignment) {
  2018. if (is<ArrayExpression>(*lhs) || is<ObjectExpression>(*lhs)) {
  2019. auto binding_pattern = synthesize_binding_pattern(*lhs);
  2020. if (binding_pattern) {
  2021. auto rhs = parse_expression(min_precedence, associativity);
  2022. return create_ast_node<AssignmentExpression>(
  2023. { m_source_code, rule_start.position(), position() },
  2024. assignment_op,
  2025. binding_pattern.release_nonnull(),
  2026. move(rhs));
  2027. }
  2028. }
  2029. }
  2030. if (!is<Identifier>(*lhs) && !is<MemberExpression>(*lhs) && !is<CallExpression>(*lhs)) {
  2031. syntax_error("Invalid left-hand side in assignment");
  2032. } else if (m_state.strict_mode && is<Identifier>(*lhs)) {
  2033. auto const& name = static_cast<Identifier const&>(*lhs).string();
  2034. check_identifier_name_for_assignment_validity(name);
  2035. } else if (m_state.strict_mode && is<CallExpression>(*lhs)) {
  2036. syntax_error("Cannot assign to function call");
  2037. }
  2038. auto rhs = parse_expression(min_precedence, associativity, forbidden);
  2039. return create_ast_node<AssignmentExpression>({ m_source_code, rule_start.position(), position() }, assignment_op, move(lhs), move(rhs));
  2040. }
  2041. NonnullRefPtr<Identifier> Parser::parse_identifier()
  2042. {
  2043. auto identifier_start = position();
  2044. auto token = consume_identifier();
  2045. if (m_state.in_class_field_initializer && token.value() == "arguments"sv)
  2046. syntax_error("'arguments' is not allowed in class field initializer");
  2047. return create_ast_node<Identifier>(
  2048. { m_source_code, identifier_start, position() },
  2049. token.flystring_value());
  2050. }
  2051. Vector<CallExpression::Argument> Parser::parse_arguments()
  2052. {
  2053. Vector<CallExpression::Argument> arguments;
  2054. consume(TokenType::ParenOpen);
  2055. while (match_expression() || match(TokenType::TripleDot)) {
  2056. if (match(TokenType::TripleDot)) {
  2057. consume();
  2058. arguments.append({ parse_expression(2), true });
  2059. } else {
  2060. arguments.append({ parse_expression(2), false });
  2061. }
  2062. if (!match(TokenType::Comma))
  2063. break;
  2064. consume();
  2065. }
  2066. consume(TokenType::ParenClose);
  2067. return arguments;
  2068. }
  2069. NonnullRefPtr<Expression> Parser::parse_call_expression(NonnullRefPtr<Expression> lhs)
  2070. {
  2071. auto rule_start = push_start();
  2072. if (!m_state.allow_super_constructor_call && is<SuperExpression>(*lhs))
  2073. syntax_error("'super' keyword unexpected here");
  2074. auto arguments = parse_arguments();
  2075. if (is<SuperExpression>(*lhs))
  2076. return create_ast_node<SuperCall>({ m_source_code, rule_start.position(), position() }, move(arguments));
  2077. return create_ast_node<CallExpression>({ m_source_code, rule_start.position(), position() }, move(lhs), move(arguments));
  2078. }
  2079. NonnullRefPtr<NewExpression> Parser::parse_new_expression()
  2080. {
  2081. auto rule_start = push_start();
  2082. consume(TokenType::New);
  2083. auto callee = parse_expression(g_operator_precedence.get(TokenType::New), Associativity::Right, { TokenType::ParenOpen, TokenType::QuestionMarkPeriod });
  2084. if (is<ImportCall>(*callee))
  2085. syntax_error("Cannot call new on dynamic import", callee->source_range().start);
  2086. Vector<CallExpression::Argument> arguments;
  2087. if (match(TokenType::ParenOpen)) {
  2088. consume(TokenType::ParenOpen);
  2089. while (match_expression() || match(TokenType::TripleDot)) {
  2090. if (match(TokenType::TripleDot)) {
  2091. consume();
  2092. arguments.append({ parse_expression(2), true });
  2093. } else {
  2094. arguments.append({ parse_expression(2), false });
  2095. }
  2096. if (!match(TokenType::Comma))
  2097. break;
  2098. consume();
  2099. }
  2100. consume(TokenType::ParenClose);
  2101. }
  2102. return create_ast_node<NewExpression>({ m_source_code, rule_start.position(), position() }, move(callee), move(arguments));
  2103. }
  2104. NonnullRefPtr<YieldExpression> Parser::parse_yield_expression()
  2105. {
  2106. auto rule_start = push_start();
  2107. if (m_state.in_formal_parameter_context)
  2108. syntax_error("'Yield' expression is not allowed in formal parameters of generator function");
  2109. consume(TokenType::Yield);
  2110. RefPtr<Expression> argument;
  2111. bool yield_from = false;
  2112. if (!m_state.current_token.trivia_contains_line_terminator()) {
  2113. if (match(TokenType::Asterisk)) {
  2114. consume();
  2115. yield_from = true;
  2116. }
  2117. if (yield_from || match_expression() || match(TokenType::Class))
  2118. argument = parse_expression(2);
  2119. }
  2120. return create_ast_node<YieldExpression>({ m_source_code, rule_start.position(), position() }, move(argument), yield_from);
  2121. }
  2122. NonnullRefPtr<AwaitExpression> Parser::parse_await_expression()
  2123. {
  2124. auto rule_start = push_start();
  2125. if (m_state.in_formal_parameter_context)
  2126. syntax_error("'Await' expression is not allowed in formal parameters of an async function");
  2127. consume(TokenType::Await);
  2128. auto precedence = g_operator_precedence.get(TokenType::Await);
  2129. auto associativity = operator_associativity(TokenType::Await);
  2130. auto argument = parse_expression(precedence, associativity);
  2131. m_state.current_scope_pusher->set_contains_await_expression();
  2132. return create_ast_node<AwaitExpression>({ m_source_code, rule_start.position(), position() }, move(argument));
  2133. }
  2134. NonnullRefPtr<ReturnStatement> Parser::parse_return_statement()
  2135. {
  2136. auto rule_start = push_start();
  2137. if (!m_state.in_function_context && !m_state.in_arrow_function_context)
  2138. syntax_error("'return' not allowed outside of a function");
  2139. consume(TokenType::Return);
  2140. // Automatic semicolon insertion: terminate statement when return is followed by newline
  2141. if (m_state.current_token.trivia_contains_line_terminator())
  2142. return create_ast_node<ReturnStatement>({ m_source_code, rule_start.position(), position() }, nullptr);
  2143. if (match_expression()) {
  2144. auto expression = parse_expression(0);
  2145. consume_or_insert_semicolon();
  2146. return create_ast_node<ReturnStatement>({ m_source_code, rule_start.position(), position() }, move(expression));
  2147. }
  2148. consume_or_insert_semicolon();
  2149. return create_ast_node<ReturnStatement>({ m_source_code, rule_start.position(), position() }, nullptr);
  2150. }
  2151. void Parser::parse_statement_list(ScopeNode& output_node, AllowLabelledFunction allow_labelled_functions)
  2152. {
  2153. while (!done()) {
  2154. if (match_declaration()) {
  2155. auto declaration = parse_declaration();
  2156. VERIFY(m_state.current_scope_pusher);
  2157. m_state.current_scope_pusher->add_declaration(declaration);
  2158. output_node.append(move(declaration));
  2159. } else if (match_statement()) {
  2160. output_node.append(parse_statement(allow_labelled_functions));
  2161. } else {
  2162. break;
  2163. }
  2164. }
  2165. }
  2166. // FunctionBody, https://tc39.es/ecma262/#prod-FunctionBody
  2167. NonnullRefPtr<FunctionBody> Parser::parse_function_body(Vector<FunctionDeclaration::Parameter> const& parameters, FunctionKind function_kind, bool& contains_direct_call_to_eval)
  2168. {
  2169. auto rule_start = push_start();
  2170. auto function_body = create_ast_node<FunctionBody>({ m_source_code, rule_start.position(), position() });
  2171. ScopePusher function_scope = ScopePusher::function_scope(*this, function_body, parameters); // FIXME <-
  2172. auto has_use_strict = parse_directive(function_body);
  2173. bool previous_strict_mode = m_state.strict_mode;
  2174. if (has_use_strict) {
  2175. m_state.strict_mode = true;
  2176. function_body->set_strict_mode();
  2177. if (!is_simple_parameter_list(parameters))
  2178. syntax_error("Illegal 'use strict' directive in function with non-simple parameter list");
  2179. } else if (previous_strict_mode) {
  2180. function_body->set_strict_mode();
  2181. }
  2182. parse_statement_list(function_body);
  2183. // If we're parsing the function body standalone, e.g. via CreateDynamicFunction, we must have reached EOF here.
  2184. // Otherwise, we need a closing curly bracket (which is consumed elsewhere). If we get neither, it's an error.
  2185. if (!match(TokenType::Eof) && !match(TokenType::CurlyClose))
  2186. expected(Token::name(TokenType::CurlyClose));
  2187. // If the function contains 'use strict' we need to check the parameters (again).
  2188. if (function_body->in_strict_mode() || function_kind != FunctionKind::Normal) {
  2189. Vector<StringView> parameter_names;
  2190. for (auto& parameter : parameters) {
  2191. parameter.binding.visit(
  2192. [&](FlyString const& parameter_name) {
  2193. check_identifier_name_for_assignment_validity(parameter_name, function_body->in_strict_mode());
  2194. if (function_kind == FunctionKind::Generator && parameter_name == "yield"sv)
  2195. syntax_error("Parameter name 'yield' not allowed in this context");
  2196. if (function_kind == FunctionKind::Async && parameter_name == "await"sv)
  2197. syntax_error("Parameter name 'await' not allowed in this context");
  2198. for (auto& previous_name : parameter_names) {
  2199. if (previous_name == parameter_name) {
  2200. syntax_error(String::formatted("Duplicate parameter '{}' not allowed in strict mode", parameter_name));
  2201. }
  2202. }
  2203. parameter_names.append(parameter_name);
  2204. },
  2205. [&](NonnullRefPtr<BindingPattern> const& binding) {
  2206. binding->for_each_bound_name([&](auto& bound_name) {
  2207. if (function_kind == FunctionKind::Generator && bound_name == "yield"sv)
  2208. syntax_error("Parameter name 'yield' not allowed in this context");
  2209. if (function_kind == FunctionKind::Async && bound_name == "await"sv)
  2210. syntax_error("Parameter name 'await' not allowed in this context");
  2211. for (auto& previous_name : parameter_names) {
  2212. if (previous_name == bound_name) {
  2213. syntax_error(String::formatted("Duplicate parameter '{}' not allowed in strict mode", bound_name));
  2214. break;
  2215. }
  2216. }
  2217. parameter_names.append(bound_name);
  2218. });
  2219. });
  2220. }
  2221. }
  2222. m_state.strict_mode = previous_strict_mode;
  2223. contains_direct_call_to_eval = function_scope.contains_direct_call_to_eval();
  2224. return function_body;
  2225. }
  2226. NonnullRefPtr<BlockStatement> Parser::parse_block_statement()
  2227. {
  2228. auto rule_start = push_start();
  2229. auto block = create_ast_node<BlockStatement>({ m_source_code, rule_start.position(), position() });
  2230. ScopePusher block_scope = ScopePusher::block_scope(*this, block);
  2231. consume(TokenType::CurlyOpen);
  2232. parse_statement_list(block);
  2233. consume(TokenType::CurlyClose);
  2234. return block;
  2235. }
  2236. template<typename FunctionNodeType>
  2237. NonnullRefPtr<FunctionNodeType> Parser::parse_function_node(u16 parse_options, Optional<Position> const& function_start)
  2238. {
  2239. auto rule_start = function_start.has_value()
  2240. ? RulePosition { *this, *function_start }
  2241. : push_start();
  2242. VERIFY(!(parse_options & FunctionNodeParseOptions::IsGetterFunction && parse_options & FunctionNodeParseOptions::IsSetterFunction));
  2243. TemporaryChange super_property_access_rollback(m_state.allow_super_property_lookup, !!(parse_options & FunctionNodeParseOptions::AllowSuperPropertyLookup));
  2244. TemporaryChange super_constructor_call_rollback(m_state.allow_super_constructor_call, !!(parse_options & FunctionNodeParseOptions::AllowSuperConstructorCall));
  2245. TemporaryChange break_context_rollback(m_state.in_break_context, false);
  2246. TemporaryChange continue_context_rollback(m_state.in_continue_context, false);
  2247. TemporaryChange class_field_initializer_rollback(m_state.in_class_field_initializer, false);
  2248. TemporaryChange might_need_arguments_object_rollback(m_state.function_might_need_arguments_object, false);
  2249. constexpr auto is_function_expression = IsSame<FunctionNodeType, FunctionExpression>;
  2250. FunctionKind function_kind;
  2251. if ((parse_options & FunctionNodeParseOptions::IsGeneratorFunction) != 0 && (parse_options & FunctionNodeParseOptions::IsAsyncFunction) != 0)
  2252. function_kind = FunctionKind::AsyncGenerator;
  2253. else if ((parse_options & FunctionNodeParseOptions::IsGeneratorFunction) != 0)
  2254. function_kind = FunctionKind::Generator;
  2255. else if ((parse_options & FunctionNodeParseOptions::IsAsyncFunction) != 0)
  2256. function_kind = FunctionKind::Async;
  2257. else
  2258. function_kind = FunctionKind::Normal;
  2259. FlyString name;
  2260. if (parse_options & FunctionNodeParseOptions::CheckForFunctionAndName) {
  2261. if (function_kind == FunctionKind::Normal && match(TokenType::Async) && !next_token().trivia_contains_line_terminator()) {
  2262. function_kind = FunctionKind::Async;
  2263. consume(TokenType::Async);
  2264. parse_options |= FunctionNodeParseOptions::IsAsyncFunction;
  2265. }
  2266. consume(TokenType::Function);
  2267. if (match(TokenType::Asterisk)) {
  2268. function_kind = function_kind == FunctionKind::Normal ? FunctionKind::Generator : FunctionKind::AsyncGenerator;
  2269. consume(TokenType::Asterisk);
  2270. parse_options |= FunctionNodeParseOptions::IsGeneratorFunction;
  2271. }
  2272. if (parse_options & FunctionNodeParseOptions::HasDefaultExportName)
  2273. name = ExportStatement::local_name_for_default;
  2274. else if (FunctionNodeType::must_have_name() || match_identifier())
  2275. name = consume_identifier().flystring_value();
  2276. else if (is_function_expression && (match(TokenType::Yield) || match(TokenType::Await)))
  2277. name = consume().flystring_value();
  2278. check_identifier_name_for_assignment_validity(name);
  2279. if (function_kind == FunctionKind::AsyncGenerator && (name == "await"sv || name == "yield"sv))
  2280. syntax_error(String::formatted("async generator function is not allowed to be called '{}'", name));
  2281. if (m_state.in_class_static_init_block && name == "await"sv)
  2282. syntax_error("'await' is a reserved word");
  2283. }
  2284. TemporaryChange class_static_initializer_rollback(m_state.in_class_static_init_block, false);
  2285. TemporaryChange generator_change(m_state.in_generator_function_context, function_kind == FunctionKind::Generator || function_kind == FunctionKind::AsyncGenerator);
  2286. TemporaryChange async_change(m_state.await_expression_is_valid, function_kind == FunctionKind::Async || function_kind == FunctionKind::AsyncGenerator);
  2287. consume(TokenType::ParenOpen);
  2288. i32 function_length = -1;
  2289. auto parameters = parse_formal_parameters(function_length, parse_options);
  2290. consume(TokenType::ParenClose);
  2291. if (function_length == -1)
  2292. function_length = parameters.size();
  2293. TemporaryChange function_context_rollback(m_state.in_function_context, true);
  2294. auto old_labels_in_scope = move(m_state.labels_in_scope);
  2295. ScopeGuard guard([&]() {
  2296. m_state.labels_in_scope = move(old_labels_in_scope);
  2297. });
  2298. consume(TokenType::CurlyOpen);
  2299. bool contains_direct_call_to_eval = false;
  2300. auto body = parse_function_body(parameters, function_kind, contains_direct_call_to_eval);
  2301. consume(TokenType::CurlyClose);
  2302. auto has_strict_directive = body->in_strict_mode();
  2303. if (has_strict_directive)
  2304. check_identifier_name_for_assignment_validity(name, true);
  2305. auto function_start_offset = rule_start.position().offset;
  2306. auto function_end_offset = position().offset - m_state.current_token.trivia().length();
  2307. auto source_text = String { m_state.lexer.source().substring_view(function_start_offset, function_end_offset - function_start_offset) };
  2308. return create_ast_node<FunctionNodeType>(
  2309. { m_source_code, rule_start.position(), position() },
  2310. name, move(source_text), move(body), move(parameters), function_length,
  2311. function_kind, has_strict_directive, m_state.function_might_need_arguments_object,
  2312. contains_direct_call_to_eval);
  2313. }
  2314. Vector<FunctionNode::Parameter> Parser::parse_formal_parameters(int& function_length, u16 parse_options)
  2315. {
  2316. auto rule_start = push_start();
  2317. bool has_default_parameter = false;
  2318. bool has_rest_parameter = false;
  2319. TemporaryChange formal_parameter_context_change { m_state.in_formal_parameter_context, true };
  2320. Vector<FunctionNode::Parameter> parameters;
  2321. auto consume_identifier_or_binding_pattern = [&]() -> Variant<FlyString, NonnullRefPtr<BindingPattern>> {
  2322. if (auto pattern = parse_binding_pattern(AllowDuplicates::No, AllowMemberExpressions::No))
  2323. return pattern.release_nonnull();
  2324. auto token = consume_identifier();
  2325. auto parameter_name = token.flystring_value();
  2326. check_identifier_name_for_assignment_validity(parameter_name);
  2327. for (auto& parameter : parameters) {
  2328. bool has_same_name = parameter.binding.visit(
  2329. [&](FlyString const& name) {
  2330. return name == parameter_name;
  2331. },
  2332. [&](NonnullRefPtr<BindingPattern> const& bindings) {
  2333. bool found_duplicate = false;
  2334. bindings->for_each_bound_name([&](auto& bound_name) {
  2335. if (bound_name == parameter_name)
  2336. found_duplicate = true;
  2337. });
  2338. return found_duplicate;
  2339. });
  2340. if (!has_same_name)
  2341. continue;
  2342. String message;
  2343. if (parse_options & FunctionNodeParseOptions::IsArrowFunction)
  2344. message = String::formatted("Duplicate parameter '{}' not allowed in arrow function", parameter_name);
  2345. else if (m_state.strict_mode)
  2346. message = String::formatted("Duplicate parameter '{}' not allowed in strict mode", parameter_name);
  2347. else if (has_default_parameter || match(TokenType::Equals))
  2348. message = String::formatted("Duplicate parameter '{}' not allowed in function with default parameter", parameter_name);
  2349. else if (has_rest_parameter)
  2350. message = String::formatted("Duplicate parameter '{}' not allowed in function with rest parameter", parameter_name);
  2351. if (!message.is_empty())
  2352. syntax_error(message, Position { token.line_number(), token.line_column() });
  2353. break;
  2354. }
  2355. return FlyString { token.value() };
  2356. };
  2357. while (match(TokenType::CurlyOpen) || match(TokenType::BracketOpen) || match_identifier() || match(TokenType::TripleDot)) {
  2358. if (parse_options & FunctionNodeParseOptions::IsGetterFunction)
  2359. syntax_error("Getter function must have no arguments");
  2360. if (parse_options & FunctionNodeParseOptions::IsSetterFunction && (parameters.size() >= 1 || match(TokenType::TripleDot)))
  2361. syntax_error("Setter function must have one argument");
  2362. auto is_rest = false;
  2363. if (match(TokenType::TripleDot)) {
  2364. consume();
  2365. has_rest_parameter = true;
  2366. function_length = parameters.size();
  2367. is_rest = true;
  2368. }
  2369. auto parameter = consume_identifier_or_binding_pattern();
  2370. RefPtr<Expression> default_value;
  2371. if (match(TokenType::Equals)) {
  2372. consume();
  2373. if (is_rest)
  2374. syntax_error("Rest parameter may not have a default initializer");
  2375. TemporaryChange change(m_state.in_function_context, true);
  2376. has_default_parameter = true;
  2377. function_length = parameters.size();
  2378. default_value = parse_expression(2);
  2379. bool is_generator = parse_options & FunctionNodeParseOptions::IsGeneratorFunction;
  2380. if ((is_generator || m_state.strict_mode) && default_value && default_value->fast_is<Identifier>() && static_cast<Identifier&>(*default_value).string() == "yield"sv)
  2381. syntax_error("Generator function parameter initializer cannot contain a reference to an identifier named \"yield\"");
  2382. }
  2383. parameters.append({ move(parameter), default_value, is_rest });
  2384. if (!match(TokenType::Comma) || is_rest)
  2385. break;
  2386. consume(TokenType::Comma);
  2387. }
  2388. if (parse_options & FunctionNodeParseOptions::IsSetterFunction && parameters.is_empty())
  2389. syntax_error("Setter function must have one argument");
  2390. // If we're parsing the parameters standalone, e.g. via CreateDynamicFunction, we must have reached EOF here.
  2391. // Otherwise, we need a closing parenthesis (which is consumed elsewhere). If we get neither, it's an error.
  2392. if (!match(TokenType::Eof) && !match(TokenType::ParenClose))
  2393. expected(Token::name(TokenType::ParenClose));
  2394. return parameters;
  2395. }
  2396. static AK::Array<FlyString, 36> s_reserved_words = { "break", "case", "catch", "class", "const", "continue", "debugger", "default", "delete", "do", "else", "enum", "export", "extends", "false", "finally", "for", "function", "if", "import", "in", "instanceof", "new", "null", "return", "super", "switch", "this", "throw", "true", "try", "typeof", "var", "void", "while", "with" };
  2397. RefPtr<BindingPattern> Parser::parse_binding_pattern(Parser::AllowDuplicates allow_duplicates, Parser::AllowMemberExpressions allow_member_expressions)
  2398. {
  2399. auto rule_start = push_start();
  2400. TokenType closing_token;
  2401. bool is_object = true;
  2402. if (match(TokenType::BracketOpen)) {
  2403. consume();
  2404. closing_token = TokenType::BracketClose;
  2405. is_object = false;
  2406. } else if (match(TokenType::CurlyOpen)) {
  2407. consume();
  2408. closing_token = TokenType::CurlyClose;
  2409. } else {
  2410. return {};
  2411. }
  2412. Vector<BindingPattern::BindingEntry> entries;
  2413. while (!match(closing_token)) {
  2414. if (!is_object && match(TokenType::Comma)) {
  2415. consume();
  2416. entries.append(BindingPattern::BindingEntry {});
  2417. continue;
  2418. }
  2419. auto is_rest = false;
  2420. if (match(TokenType::TripleDot)) {
  2421. consume();
  2422. is_rest = true;
  2423. }
  2424. decltype(BindingPattern::BindingEntry::name) name = Empty {};
  2425. decltype(BindingPattern::BindingEntry::alias) alias = Empty {};
  2426. RefPtr<Expression> initializer = {};
  2427. if (is_object) {
  2428. bool needs_alias = false;
  2429. if (allow_member_expressions == AllowMemberExpressions::Yes && is_rest) {
  2430. auto expression_position = position();
  2431. auto expression = parse_expression(2, Associativity::Right, { TokenType::Equals });
  2432. if (is<MemberExpression>(*expression))
  2433. alias = static_ptr_cast<MemberExpression>(expression);
  2434. else if (is<Identifier>(*expression))
  2435. name = static_ptr_cast<Identifier>(expression);
  2436. else
  2437. syntax_error("Invalid destructuring assignment target", expression_position);
  2438. } else if (match_identifier_name() || match(TokenType::StringLiteral) || match(TokenType::NumericLiteral) || match(TokenType::BigIntLiteral)) {
  2439. if (match(TokenType::StringLiteral) || match(TokenType::NumericLiteral))
  2440. needs_alias = true;
  2441. if (match(TokenType::StringLiteral)) {
  2442. auto token = consume(TokenType::StringLiteral);
  2443. auto string_literal = parse_string_literal(token);
  2444. name = create_ast_node<Identifier>(
  2445. { m_source_code, rule_start.position(), position() },
  2446. string_literal->value());
  2447. } else if (match(TokenType::BigIntLiteral)) {
  2448. auto string_value = consume().flystring_value();
  2449. VERIFY(string_value.ends_with("n"sv));
  2450. name = create_ast_node<Identifier>(
  2451. { m_source_code, rule_start.position(), position() },
  2452. FlyString(string_value.view().substring_view(0, string_value.length() - 1)));
  2453. } else {
  2454. name = create_ast_node<Identifier>(
  2455. { m_source_code, rule_start.position(), position() },
  2456. consume().flystring_value());
  2457. }
  2458. } else if (match(TokenType::BracketOpen)) {
  2459. consume();
  2460. auto expression = parse_expression(0);
  2461. name = move(expression);
  2462. consume(TokenType::BracketClose);
  2463. } else {
  2464. expected("identifier or computed property name");
  2465. return {};
  2466. }
  2467. if (!is_rest && match(TokenType::Colon)) {
  2468. consume();
  2469. if (allow_member_expressions == AllowMemberExpressions::Yes) {
  2470. auto expression_position = position();
  2471. auto expression = parse_expression(2, Associativity::Right, { TokenType::Equals });
  2472. if (is<ArrayExpression>(*expression) || is<ObjectExpression>(*expression)) {
  2473. if (auto synthesized_binding_pattern = synthesize_binding_pattern(*expression))
  2474. alias = synthesized_binding_pattern.release_nonnull();
  2475. else
  2476. syntax_error("Invalid destructuring assignment target", expression_position);
  2477. } else if (is<MemberExpression>(*expression)) {
  2478. alias = static_ptr_cast<MemberExpression>(expression);
  2479. } else if (is<Identifier>(*expression)) {
  2480. alias = static_ptr_cast<Identifier>(expression);
  2481. } else {
  2482. syntax_error("Invalid destructuring assignment target", expression_position);
  2483. }
  2484. } else if (match(TokenType::CurlyOpen) || match(TokenType::BracketOpen)) {
  2485. auto binding_pattern = parse_binding_pattern(allow_duplicates, allow_member_expressions);
  2486. if (!binding_pattern)
  2487. return {};
  2488. alias = binding_pattern.release_nonnull();
  2489. } else if (match_identifier_name()) {
  2490. alias = create_ast_node<Identifier>(
  2491. { m_source_code, rule_start.position(), position() },
  2492. consume().flystring_value());
  2493. } else {
  2494. expected("identifier or binding pattern");
  2495. return {};
  2496. }
  2497. } else if (needs_alias) {
  2498. expected("alias for string or numeric literal name");
  2499. return {};
  2500. }
  2501. } else {
  2502. if (allow_member_expressions == AllowMemberExpressions::Yes) {
  2503. auto expression_position = position();
  2504. auto expression = parse_expression(2, Associativity::Right, { TokenType::Equals });
  2505. if (is<ArrayExpression>(*expression) || is<ObjectExpression>(*expression)) {
  2506. if (auto synthesized_binding_pattern = synthesize_binding_pattern(*expression))
  2507. alias = synthesized_binding_pattern.release_nonnull();
  2508. else
  2509. syntax_error("Invalid destructuring assignment target", expression_position);
  2510. } else if (is<MemberExpression>(*expression)) {
  2511. alias = static_ptr_cast<MemberExpression>(expression);
  2512. } else if (is<Identifier>(*expression)) {
  2513. alias = static_ptr_cast<Identifier>(expression);
  2514. } else {
  2515. syntax_error("Invalid destructuring assignment target", expression_position);
  2516. }
  2517. } else if (match(TokenType::BracketOpen) || match(TokenType::CurlyOpen)) {
  2518. auto pattern = parse_binding_pattern(allow_duplicates, allow_member_expressions);
  2519. if (!pattern) {
  2520. expected("binding pattern");
  2521. return {};
  2522. }
  2523. alias = pattern.release_nonnull();
  2524. } else if (match_identifier_name()) {
  2525. // BindingElement must always have an Empty name field
  2526. auto identifier_name = consume_identifier().flystring_value();
  2527. alias = create_ast_node<Identifier>(
  2528. { m_source_code, rule_start.position(), position() },
  2529. identifier_name);
  2530. } else {
  2531. expected("identifier or binding pattern");
  2532. return {};
  2533. }
  2534. }
  2535. if (match(TokenType::Equals)) {
  2536. if (is_rest) {
  2537. syntax_error("Unexpected initializer after rest element");
  2538. return {};
  2539. }
  2540. consume();
  2541. initializer = parse_expression(2);
  2542. if (!initializer) {
  2543. expected("initialization expression");
  2544. return {};
  2545. }
  2546. }
  2547. entries.append(BindingPattern::BindingEntry { move(name), move(alias), move(initializer), is_rest });
  2548. if (match(TokenType::Comma)) {
  2549. if (is_rest) {
  2550. syntax_error("Rest element may not be followed by a comma");
  2551. return {};
  2552. }
  2553. consume();
  2554. } else if (is_object && !match(TokenType::CurlyClose)) {
  2555. consume(TokenType::Comma);
  2556. }
  2557. }
  2558. while (!is_object && match(TokenType::Comma))
  2559. consume();
  2560. consume(closing_token);
  2561. auto kind = is_object ? BindingPattern::Kind::Object : BindingPattern::Kind::Array;
  2562. auto pattern = adopt_ref(*new BindingPattern);
  2563. pattern->entries = move(entries);
  2564. pattern->kind = kind;
  2565. Vector<StringView> bound_names;
  2566. pattern->for_each_bound_name([&](auto& name) {
  2567. if (allow_duplicates == AllowDuplicates::No) {
  2568. if (bound_names.contains_slow(name))
  2569. syntax_error("Duplicate parameter names in bindings");
  2570. bound_names.append(name);
  2571. }
  2572. check_identifier_name_for_assignment_validity(name);
  2573. });
  2574. return pattern;
  2575. }
  2576. NonnullRefPtr<VariableDeclaration> Parser::parse_variable_declaration(bool for_loop_variable_declaration)
  2577. {
  2578. auto rule_start = push_start();
  2579. DeclarationKind declaration_kind;
  2580. switch (m_state.current_token.type()) {
  2581. case TokenType::Var:
  2582. declaration_kind = DeclarationKind::Var;
  2583. break;
  2584. case TokenType::Let:
  2585. declaration_kind = DeclarationKind::Let;
  2586. break;
  2587. case TokenType::Const:
  2588. declaration_kind = DeclarationKind::Const;
  2589. break;
  2590. default:
  2591. VERIFY_NOT_REACHED();
  2592. }
  2593. consume();
  2594. NonnullRefPtrVector<VariableDeclarator> declarations;
  2595. for (;;) {
  2596. Variant<NonnullRefPtr<Identifier>, NonnullRefPtr<BindingPattern>, Empty> target {};
  2597. if (match_identifier()) {
  2598. auto identifier_start = push_start();
  2599. auto name = consume_identifier().flystring_value();
  2600. target = create_ast_node<Identifier>(
  2601. { m_source_code, rule_start.position(), position() },
  2602. name);
  2603. check_identifier_name_for_assignment_validity(name);
  2604. if ((declaration_kind == DeclarationKind::Let || declaration_kind == DeclarationKind::Const) && name == "let"sv)
  2605. syntax_error("Lexical binding may not be called 'let'");
  2606. } else if (auto pattern = parse_binding_pattern(declaration_kind != DeclarationKind::Var ? AllowDuplicates::No : AllowDuplicates::Yes, AllowMemberExpressions::No)) {
  2607. target = pattern.release_nonnull();
  2608. if ((declaration_kind == DeclarationKind::Let || declaration_kind == DeclarationKind::Const)) {
  2609. target.get<NonnullRefPtr<BindingPattern>>()->for_each_bound_name([this](auto& name) {
  2610. if (name == "let"sv)
  2611. syntax_error("Lexical binding may not be called 'let'");
  2612. });
  2613. }
  2614. } else if (!m_state.in_generator_function_context && match(TokenType::Yield)) {
  2615. if (m_state.strict_mode)
  2616. syntax_error("Identifier must not be a reserved word in strict mode ('yield')");
  2617. target = create_ast_node<Identifier>(
  2618. { m_source_code, rule_start.position(), position() },
  2619. consume().flystring_value());
  2620. } else if (!m_state.await_expression_is_valid && match(TokenType::Async)) {
  2621. if (m_program_type == Program::Type::Module)
  2622. syntax_error("Identifier must not be a reserved word in modules ('async')");
  2623. target = create_ast_node<Identifier>(
  2624. { m_source_code, rule_start.position(), position() },
  2625. consume().flystring_value());
  2626. }
  2627. if (target.has<Empty>()) {
  2628. expected("identifier or a binding pattern");
  2629. if (match(TokenType::Comma)) {
  2630. consume();
  2631. continue;
  2632. }
  2633. break;
  2634. }
  2635. RefPtr<Expression> init;
  2636. if (match(TokenType::Equals)) {
  2637. consume();
  2638. // In a for loop 'in' can be ambiguous so we do not allow it
  2639. // 14.7.4 The for Statement, https://tc39.es/ecma262/#prod-ForStatement and 14.7.5 The for-in, for-of, and for-await-of Statements, https://tc39.es/ecma262/#prod-ForInOfStatement
  2640. if (for_loop_variable_declaration)
  2641. init = parse_expression(2, Associativity::Right, { TokenType::In });
  2642. else
  2643. init = parse_expression(2);
  2644. } else if (!for_loop_variable_declaration && declaration_kind == DeclarationKind::Const) {
  2645. syntax_error("Missing initializer in 'const' variable declaration");
  2646. } else if (!for_loop_variable_declaration && target.has<NonnullRefPtr<BindingPattern>>()) {
  2647. syntax_error("Missing initializer in destructuring assignment");
  2648. }
  2649. declarations.append(create_ast_node<VariableDeclarator>(
  2650. { m_source_code, rule_start.position(), position() },
  2651. move(target).downcast<NonnullRefPtr<Identifier>, NonnullRefPtr<BindingPattern>>(),
  2652. move(init)));
  2653. if (match(TokenType::Comma)) {
  2654. consume();
  2655. continue;
  2656. }
  2657. break;
  2658. }
  2659. if (!for_loop_variable_declaration)
  2660. consume_or_insert_semicolon();
  2661. auto declaration = create_ast_node<VariableDeclaration>({ m_source_code, rule_start.position(), position() }, declaration_kind, move(declarations));
  2662. return declaration;
  2663. }
  2664. NonnullRefPtr<ThrowStatement> Parser::parse_throw_statement()
  2665. {
  2666. auto rule_start = push_start();
  2667. consume(TokenType::Throw);
  2668. // Automatic semicolon insertion: terminate statement when throw is followed by newline
  2669. if (m_state.current_token.trivia_contains_line_terminator()) {
  2670. syntax_error("No line break is allowed between 'throw' and its expression");
  2671. return create_ast_node<ThrowStatement>({ m_source_code, rule_start.position(), position() }, create_ast_node<ErrorExpression>({ m_source_code, rule_start.position(), position() }));
  2672. }
  2673. auto expression = parse_expression(0);
  2674. consume_or_insert_semicolon();
  2675. return create_ast_node<ThrowStatement>({ m_source_code, rule_start.position(), position() }, move(expression));
  2676. }
  2677. NonnullRefPtr<BreakStatement> Parser::parse_break_statement()
  2678. {
  2679. auto rule_start = push_start();
  2680. consume(TokenType::Break);
  2681. FlyString target_label;
  2682. if (match(TokenType::Semicolon)) {
  2683. consume();
  2684. } else {
  2685. if (!m_state.current_token.trivia_contains_line_terminator() && match_identifier()) {
  2686. target_label = consume().value();
  2687. auto label = m_state.labels_in_scope.find(target_label);
  2688. if (label == m_state.labels_in_scope.end())
  2689. syntax_error(String::formatted("Label '{}' not found", target_label));
  2690. }
  2691. consume_or_insert_semicolon();
  2692. }
  2693. if (target_label.is_null() && !m_state.in_break_context)
  2694. syntax_error("Unlabeled 'break' not allowed outside of a loop or switch statement");
  2695. return create_ast_node<BreakStatement>({ m_source_code, rule_start.position(), position() }, target_label);
  2696. }
  2697. NonnullRefPtr<ContinueStatement> Parser::parse_continue_statement()
  2698. {
  2699. auto rule_start = push_start();
  2700. if (!m_state.in_continue_context)
  2701. syntax_error("'continue' not allow outside of a loop");
  2702. consume(TokenType::Continue);
  2703. FlyString target_label;
  2704. if (match(TokenType::Semicolon)) {
  2705. consume();
  2706. return create_ast_node<ContinueStatement>({ m_source_code, rule_start.position(), position() }, target_label);
  2707. }
  2708. if (!m_state.current_token.trivia_contains_line_terminator() && match_identifier()) {
  2709. auto label_position = position();
  2710. target_label = consume().value();
  2711. auto label = m_state.labels_in_scope.find(target_label);
  2712. if (label == m_state.labels_in_scope.end())
  2713. syntax_error(String::formatted("Label '{}' not found or invalid", target_label));
  2714. else
  2715. label->value = label_position;
  2716. }
  2717. consume_or_insert_semicolon();
  2718. return create_ast_node<ContinueStatement>({ m_source_code, rule_start.position(), position() }, target_label);
  2719. }
  2720. NonnullRefPtr<ConditionalExpression> Parser::parse_conditional_expression(NonnullRefPtr<Expression> test, ForbiddenTokens forbidden)
  2721. {
  2722. auto rule_start = push_start();
  2723. consume(TokenType::QuestionMark);
  2724. auto consequent = parse_expression(2);
  2725. consume(TokenType::Colon);
  2726. auto alternate = parse_expression(2, Associativity::Right, forbidden);
  2727. return create_ast_node<ConditionalExpression>({ m_source_code, rule_start.position(), position() }, move(test), move(consequent), move(alternate));
  2728. }
  2729. NonnullRefPtr<OptionalChain> Parser::parse_optional_chain(NonnullRefPtr<Expression> base)
  2730. {
  2731. auto rule_start = push_start();
  2732. Vector<OptionalChain::Reference> chain;
  2733. do {
  2734. if (match(TokenType::QuestionMarkPeriod)) {
  2735. consume(TokenType::QuestionMarkPeriod);
  2736. switch (m_state.current_token.type()) {
  2737. case TokenType::ParenOpen:
  2738. chain.append(OptionalChain::Call { parse_arguments(), OptionalChain::Mode::Optional });
  2739. break;
  2740. case TokenType::BracketOpen:
  2741. consume();
  2742. chain.append(OptionalChain::ComputedReference { parse_expression(0), OptionalChain::Mode::Optional });
  2743. consume(TokenType::BracketClose);
  2744. break;
  2745. case TokenType::PrivateIdentifier: {
  2746. if (!is_private_identifier_valid())
  2747. syntax_error(String::formatted("Reference to undeclared private field or method '{}'", m_state.current_token.value()));
  2748. auto start = position();
  2749. auto private_identifier = consume();
  2750. chain.append(OptionalChain::PrivateMemberReference {
  2751. create_ast_node<PrivateIdentifier>({ m_source_code, start, position() }, private_identifier.value()),
  2752. OptionalChain::Mode::Optional });
  2753. break;
  2754. }
  2755. case TokenType::TemplateLiteralStart:
  2756. // 13.3.1.1 - Static Semantics: Early Errors
  2757. // OptionalChain :
  2758. // ?. TemplateLiteral
  2759. // OptionalChain TemplateLiteral
  2760. // This is a hard error.
  2761. syntax_error("Invalid tagged template literal after ?.", position());
  2762. break;
  2763. default:
  2764. if (match_identifier_name()) {
  2765. auto start = position();
  2766. auto identifier = consume();
  2767. chain.append(OptionalChain::MemberReference {
  2768. create_ast_node<Identifier>({ m_source_code, start, position() }, identifier.flystring_value()),
  2769. OptionalChain::Mode::Optional,
  2770. });
  2771. } else {
  2772. syntax_error("Invalid optional chain reference after ?.", position());
  2773. }
  2774. break;
  2775. }
  2776. } else if (match(TokenType::ParenOpen)) {
  2777. chain.append(OptionalChain::Call { parse_arguments(), OptionalChain::Mode::NotOptional });
  2778. } else if (match(TokenType::Period)) {
  2779. consume();
  2780. if (match(TokenType::PrivateIdentifier)) {
  2781. if (!is_private_identifier_valid())
  2782. syntax_error(String::formatted("Reference to undeclared private field or method '{}'", m_state.current_token.value()));
  2783. auto start = position();
  2784. auto private_identifier = consume();
  2785. chain.append(OptionalChain::PrivateMemberReference {
  2786. create_ast_node<PrivateIdentifier>({ m_source_code, start, position() }, private_identifier.value()),
  2787. OptionalChain::Mode::NotOptional,
  2788. });
  2789. } else if (match_identifier_name()) {
  2790. auto start = position();
  2791. auto identifier = consume();
  2792. chain.append(OptionalChain::MemberReference {
  2793. create_ast_node<Identifier>({ m_source_code, start, position() }, identifier.flystring_value()),
  2794. OptionalChain::Mode::NotOptional,
  2795. });
  2796. } else {
  2797. expected("an identifier");
  2798. break;
  2799. }
  2800. } else if (match(TokenType::TemplateLiteralStart)) {
  2801. // 13.3.1.1 - Static Semantics: Early Errors
  2802. // OptionalChain :
  2803. // ?. TemplateLiteral
  2804. // OptionalChain TemplateLiteral
  2805. syntax_error("Invalid tagged template literal after optional chain", position());
  2806. break;
  2807. } else if (match(TokenType::BracketOpen)) {
  2808. consume();
  2809. chain.append(OptionalChain::ComputedReference { parse_expression(2), OptionalChain::Mode::NotOptional });
  2810. consume(TokenType::BracketClose);
  2811. } else {
  2812. break;
  2813. }
  2814. } while (!done());
  2815. return create_ast_node<OptionalChain>(
  2816. { m_source_code, rule_start.position(), position() },
  2817. move(base),
  2818. move(chain));
  2819. }
  2820. NonnullRefPtr<TryStatement> Parser::parse_try_statement()
  2821. {
  2822. auto rule_start = push_start();
  2823. consume(TokenType::Try);
  2824. auto block = parse_block_statement();
  2825. RefPtr<CatchClause> handler;
  2826. if (match(TokenType::Catch))
  2827. handler = parse_catch_clause();
  2828. RefPtr<BlockStatement> finalizer;
  2829. if (match(TokenType::Finally)) {
  2830. consume();
  2831. finalizer = parse_block_statement();
  2832. }
  2833. if (!handler && !finalizer)
  2834. syntax_error("try statement must have a 'catch' or 'finally' clause");
  2835. return create_ast_node<TryStatement>({ m_source_code, rule_start.position(), position() }, move(block), move(handler), move(finalizer));
  2836. }
  2837. NonnullRefPtr<DoWhileStatement> Parser::parse_do_while_statement()
  2838. {
  2839. auto rule_start = push_start();
  2840. consume(TokenType::Do);
  2841. auto body = [&]() -> NonnullRefPtr<Statement> {
  2842. TemporaryChange break_change(m_state.in_break_context, true);
  2843. TemporaryChange continue_change(m_state.in_continue_context, true);
  2844. return parse_statement();
  2845. }();
  2846. consume(TokenType::While);
  2847. consume(TokenType::ParenOpen);
  2848. auto test = parse_expression(0);
  2849. consume(TokenType::ParenClose);
  2850. // Since ES 2015 a missing semicolon is inserted here, despite the regular ASI rules not applying
  2851. if (match(TokenType::Semicolon))
  2852. consume();
  2853. return create_ast_node<DoWhileStatement>({ m_source_code, rule_start.position(), position() }, move(test), move(body));
  2854. }
  2855. NonnullRefPtr<WhileStatement> Parser::parse_while_statement()
  2856. {
  2857. auto rule_start = push_start();
  2858. consume(TokenType::While);
  2859. consume(TokenType::ParenOpen);
  2860. auto test = parse_expression(0);
  2861. consume(TokenType::ParenClose);
  2862. TemporaryChange break_change(m_state.in_break_context, true);
  2863. TemporaryChange continue_change(m_state.in_continue_context, true);
  2864. auto body = parse_statement();
  2865. return create_ast_node<WhileStatement>({ m_source_code, rule_start.position(), position() }, move(test), move(body));
  2866. }
  2867. NonnullRefPtr<SwitchStatement> Parser::parse_switch_statement()
  2868. {
  2869. auto rule_start = push_start();
  2870. consume(TokenType::Switch);
  2871. consume(TokenType::ParenOpen);
  2872. auto determinant = parse_expression(0);
  2873. consume(TokenType::ParenClose);
  2874. consume(TokenType::CurlyOpen);
  2875. NonnullRefPtrVector<SwitchCase> cases;
  2876. auto switch_statement = create_ast_node<SwitchStatement>({ m_source_code, rule_start.position(), position() }, move(determinant));
  2877. ScopePusher switch_scope = ScopePusher::block_scope(*this, switch_statement);
  2878. auto has_default = false;
  2879. while (match(TokenType::Case) || match(TokenType::Default)) {
  2880. if (match(TokenType::Default)) {
  2881. if (has_default)
  2882. syntax_error("Multiple 'default' clauses in switch statement");
  2883. has_default = true;
  2884. }
  2885. switch_statement->add_case(parse_switch_case());
  2886. }
  2887. consume(TokenType::CurlyClose);
  2888. return switch_statement;
  2889. }
  2890. NonnullRefPtr<WithStatement> Parser::parse_with_statement()
  2891. {
  2892. auto rule_start = push_start();
  2893. consume(TokenType::With);
  2894. consume(TokenType::ParenOpen);
  2895. auto object = parse_expression(0);
  2896. consume(TokenType::ParenClose);
  2897. auto body = parse_statement();
  2898. return create_ast_node<WithStatement>({ m_source_code, rule_start.position(), position() }, move(object), move(body));
  2899. }
  2900. NonnullRefPtr<SwitchCase> Parser::parse_switch_case()
  2901. {
  2902. auto rule_start = push_start();
  2903. RefPtr<Expression> test;
  2904. if (consume().type() == TokenType::Case) {
  2905. test = parse_expression(0);
  2906. }
  2907. consume(TokenType::Colon);
  2908. NonnullRefPtrVector<Statement> consequent;
  2909. TemporaryChange break_change(m_state.in_break_context, true);
  2910. auto switch_case = create_ast_node<SwitchCase>({ m_source_code, rule_start.position(), position() }, move(test));
  2911. parse_statement_list(switch_case);
  2912. return switch_case;
  2913. }
  2914. NonnullRefPtr<CatchClause> Parser::parse_catch_clause()
  2915. {
  2916. auto rule_start = push_start();
  2917. consume(TokenType::Catch);
  2918. FlyString parameter;
  2919. RefPtr<BindingPattern> pattern_parameter;
  2920. auto should_expect_parameter = false;
  2921. if (match(TokenType::ParenOpen)) {
  2922. should_expect_parameter = true;
  2923. consume();
  2924. if (match_identifier_name()
  2925. && (!match(TokenType::Yield) || !m_state.in_generator_function_context)
  2926. && (!match(TokenType::Async) || !m_state.await_expression_is_valid)
  2927. && (!match(TokenType::Await) || !m_state.in_class_static_init_block))
  2928. parameter = consume().value();
  2929. else
  2930. pattern_parameter = parse_binding_pattern(AllowDuplicates::No, AllowMemberExpressions::No);
  2931. consume(TokenType::ParenClose);
  2932. }
  2933. if (should_expect_parameter && parameter.is_empty() && !pattern_parameter)
  2934. expected("an identifier or a binding pattern");
  2935. HashTable<FlyString> bound_names;
  2936. if (pattern_parameter) {
  2937. pattern_parameter->for_each_bound_name(
  2938. [&](auto& name) {
  2939. check_identifier_name_for_assignment_validity(name);
  2940. bound_names.set(name);
  2941. });
  2942. }
  2943. if (!parameter.is_empty()) {
  2944. check_identifier_name_for_assignment_validity(parameter);
  2945. bound_names.set(parameter);
  2946. }
  2947. ScopePusher catch_scope = ScopePusher::catch_scope(*this, pattern_parameter, parameter);
  2948. auto body = parse_block_statement();
  2949. body->for_each_lexically_declared_name([&](auto const& name) {
  2950. if (bound_names.contains(name))
  2951. syntax_error(String::formatted("Identifier '{}' already declared as catch parameter", name));
  2952. });
  2953. if (pattern_parameter) {
  2954. return create_ast_node<CatchClause>(
  2955. { m_source_code, rule_start.position(), position() },
  2956. pattern_parameter.release_nonnull(),
  2957. move(body));
  2958. }
  2959. return create_ast_node<CatchClause>(
  2960. { m_source_code, rule_start.position(), position() },
  2961. move(parameter),
  2962. move(body));
  2963. }
  2964. NonnullRefPtr<IfStatement> Parser::parse_if_statement()
  2965. {
  2966. auto rule_start = push_start();
  2967. auto parse_function_declaration_as_block_statement = [&] {
  2968. // https://tc39.es/ecma262/#sec-functiondeclarations-in-ifstatement-statement-clauses
  2969. // This production only applies when parsing non-strict code. Source text matched
  2970. // by this production is processed as if each matching occurrence of
  2971. // FunctionDeclaration[?Yield, ?Await, ~Default] was the sole StatementListItem
  2972. // of a BlockStatement occupying that position in the source text.
  2973. // The semantics of such a synthetic BlockStatement includes the web legacy
  2974. // compatibility semantics specified in B.3.2.
  2975. VERIFY(match(TokenType::Function));
  2976. auto block = create_ast_node<BlockStatement>({ m_source_code, rule_start.position(), position() });
  2977. ScopePusher block_scope = ScopePusher::block_scope(*this, *block);
  2978. auto declaration = parse_declaration();
  2979. VERIFY(m_state.current_scope_pusher);
  2980. block_scope.add_declaration(declaration);
  2981. VERIFY(is<FunctionDeclaration>(*declaration));
  2982. auto& function_declaration = static_cast<FunctionDeclaration const&>(*declaration);
  2983. if (function_declaration.kind() == FunctionKind::Generator)
  2984. syntax_error("Generator functions can only be declared in top-level or within a block");
  2985. if (function_declaration.kind() == FunctionKind::Async)
  2986. syntax_error("Async functions can only be declared in top-level or within a block");
  2987. block->append(move(declaration));
  2988. return block;
  2989. };
  2990. consume(TokenType::If);
  2991. consume(TokenType::ParenOpen);
  2992. auto predicate = parse_expression(0);
  2993. consume(TokenType::ParenClose);
  2994. RefPtr<Statement> consequent;
  2995. if (!m_state.strict_mode && match(TokenType::Function))
  2996. consequent = parse_function_declaration_as_block_statement();
  2997. else
  2998. consequent = parse_statement();
  2999. RefPtr<Statement> alternate;
  3000. if (match(TokenType::Else)) {
  3001. consume();
  3002. if (!m_state.strict_mode && match(TokenType::Function))
  3003. alternate = parse_function_declaration_as_block_statement();
  3004. else
  3005. alternate = parse_statement();
  3006. }
  3007. return create_ast_node<IfStatement>({ m_source_code, rule_start.position(), position() }, move(predicate), move(*consequent), move(alternate));
  3008. }
  3009. NonnullRefPtr<Statement> Parser::parse_for_statement()
  3010. {
  3011. auto rule_start = push_start();
  3012. auto is_await_loop = IsForAwaitLoop::No;
  3013. auto match_of = [&](Token const& token) {
  3014. return token.type() == TokenType::Identifier && token.original_value() == "of"sv;
  3015. };
  3016. auto match_for_in_of = [&]() {
  3017. bool is_of = match_of(m_state.current_token);
  3018. if (is_await_loop == IsForAwaitLoop::Yes) {
  3019. if (!is_of)
  3020. syntax_error("for await loop is only valid with 'of'");
  3021. else if (!m_state.await_expression_is_valid)
  3022. syntax_error("for await loop is only valid in async function or generator");
  3023. return true;
  3024. }
  3025. return match(TokenType::In) || is_of;
  3026. };
  3027. consume(TokenType::For);
  3028. if (match(TokenType::Await)) {
  3029. consume();
  3030. if (!m_state.await_expression_is_valid)
  3031. syntax_error("for-await-of is only allowed in async function context");
  3032. is_await_loop = IsForAwaitLoop::Yes;
  3033. }
  3034. consume(TokenType::ParenOpen);
  3035. Optional<ScopePusher> scope_pusher;
  3036. RefPtr<ASTNode> init;
  3037. if (!match(TokenType::Semicolon)) {
  3038. if (match_variable_declaration()) {
  3039. auto declaration = parse_variable_declaration(true);
  3040. if (declaration->declaration_kind() == DeclarationKind::Var) {
  3041. m_state.current_scope_pusher->add_declaration(declaration);
  3042. } else {
  3043. // This does not follow the normal declaration structure so we need additional checks.
  3044. HashTable<FlyString> bound_names;
  3045. declaration->for_each_bound_name([&](auto const& name) {
  3046. if (bound_names.set(name) != AK::HashSetResult::InsertedNewEntry)
  3047. syntax_error(String::formatted("Identifier '{}' already declared in for loop initializer", name), declaration->source_range().start);
  3048. });
  3049. }
  3050. init = move(declaration);
  3051. if (match_for_in_of())
  3052. return parse_for_in_of_statement(*init, is_await_loop);
  3053. if (static_cast<VariableDeclaration&>(*init).declaration_kind() == DeclarationKind::Const) {
  3054. for (auto& variable : static_cast<VariableDeclaration&>(*init).declarations()) {
  3055. if (!variable.init())
  3056. syntax_error("Missing initializer in 'const' variable declaration");
  3057. }
  3058. }
  3059. } else if (match_expression()) {
  3060. auto lookahead_token = next_token();
  3061. bool starts_with_async_of = match(TokenType::Async) && match_of(lookahead_token);
  3062. init = parse_expression(0, Associativity::Right, { TokenType::In });
  3063. if (match_for_in_of()) {
  3064. if (is_await_loop != IsForAwaitLoop::Yes
  3065. && starts_with_async_of && match_of(m_state.current_token))
  3066. syntax_error("for-of loop may not start with async of");
  3067. return parse_for_in_of_statement(*init, is_await_loop);
  3068. }
  3069. } else {
  3070. syntax_error("Unexpected token in for loop");
  3071. }
  3072. }
  3073. consume(TokenType::Semicolon);
  3074. RefPtr<Expression> test;
  3075. if (!match(TokenType::Semicolon))
  3076. test = parse_expression(0);
  3077. consume(TokenType::Semicolon);
  3078. RefPtr<Expression> update;
  3079. if (!match(TokenType::ParenClose))
  3080. update = parse_expression(0);
  3081. consume(TokenType::ParenClose);
  3082. TemporaryChange break_change(m_state.in_break_context, true);
  3083. TemporaryChange continue_change(m_state.in_continue_context, true);
  3084. ScopePusher for_loop_scope = ScopePusher::for_loop_scope(*this, init);
  3085. auto body = parse_statement();
  3086. return create_ast_node<ForStatement>({ m_source_code, rule_start.position(), position() }, move(init), move(test), move(update), move(body));
  3087. }
  3088. NonnullRefPtr<Statement> Parser::parse_for_in_of_statement(NonnullRefPtr<ASTNode> lhs, IsForAwaitLoop is_for_await_loop)
  3089. {
  3090. Variant<NonnullRefPtr<ASTNode>, NonnullRefPtr<BindingPattern>> for_declaration = lhs;
  3091. auto rule_start = push_start();
  3092. auto has_annexB_for_in_init_extension = false;
  3093. if (is<VariableDeclaration>(*lhs)) {
  3094. auto& declaration = static_cast<VariableDeclaration&>(*lhs);
  3095. if (declaration.declarations().size() > 1) {
  3096. syntax_error("Multiple declarations not allowed in for..in/of");
  3097. } else if (declaration.declarations().size() < 1) {
  3098. syntax_error("Need exactly one variable declaration in for..in/of");
  3099. } else {
  3100. // AnnexB extension B.3.5 Initializers in ForIn Statement Heads, https://tc39.es/ecma262/#sec-initializers-in-forin-statement-heads
  3101. auto& variable = declaration.declarations().first();
  3102. if (variable.init()) {
  3103. if (m_state.strict_mode || declaration.declaration_kind() != DeclarationKind::Var || !variable.target().has<NonnullRefPtr<Identifier>>())
  3104. syntax_error("Variable initializer not allowed in for..in/of");
  3105. else
  3106. has_annexB_for_in_init_extension = true;
  3107. }
  3108. }
  3109. } else if (!lhs->is_identifier() && !is<MemberExpression>(*lhs) && !is<CallExpression>(*lhs)) {
  3110. bool valid = false;
  3111. if (is<ObjectExpression>(*lhs) || is<ArrayExpression>(*lhs)) {
  3112. auto synthesized_binding_pattern = synthesize_binding_pattern(static_cast<Expression const&>(*lhs));
  3113. if (synthesized_binding_pattern) {
  3114. for_declaration = synthesized_binding_pattern.release_nonnull();
  3115. valid = true;
  3116. }
  3117. }
  3118. if (!valid)
  3119. syntax_error(String::formatted("Invalid left-hand side in for-loop ('{}')", lhs->class_name()));
  3120. }
  3121. auto in_or_of = consume();
  3122. auto is_in = in_or_of.type() == TokenType::In;
  3123. if (!is_in) {
  3124. if (is<MemberExpression>(*lhs)) {
  3125. auto& member = static_cast<MemberExpression const&>(*lhs);
  3126. if (member.object().is_identifier() && static_cast<Identifier const&>(member.object()).string() == "let"sv)
  3127. syntax_error("For of statement may not start with let.");
  3128. }
  3129. if (has_annexB_for_in_init_extension)
  3130. syntax_error("Variable initializer not allowed in for..of", rule_start.position());
  3131. }
  3132. auto rhs = parse_expression(is_in ? 0 : 2);
  3133. consume(TokenType::ParenClose);
  3134. TemporaryChange break_change(m_state.in_break_context, true);
  3135. TemporaryChange continue_change(m_state.in_continue_context, true);
  3136. ScopePusher for_loop_scope = ScopePusher::for_loop_scope(*this, lhs);
  3137. auto body = parse_statement();
  3138. if (is_in)
  3139. return create_ast_node<ForInStatement>({ m_source_code, rule_start.position(), position() }, move(for_declaration), move(rhs), move(body));
  3140. if (is_for_await_loop == IsForAwaitLoop::Yes)
  3141. return create_ast_node<ForAwaitOfStatement>({ m_source_code, rule_start.position(), position() }, move(for_declaration), move(rhs), move(body));
  3142. return create_ast_node<ForOfStatement>({ m_source_code, rule_start.position(), position() }, move(for_declaration), move(rhs), move(body));
  3143. }
  3144. NonnullRefPtr<DebuggerStatement> Parser::parse_debugger_statement()
  3145. {
  3146. auto rule_start = push_start();
  3147. consume(TokenType::Debugger);
  3148. consume_or_insert_semicolon();
  3149. return create_ast_node<DebuggerStatement>({ m_source_code, rule_start.position(), position() });
  3150. }
  3151. bool Parser::match(TokenType type) const
  3152. {
  3153. return m_state.current_token.type() == type;
  3154. }
  3155. bool Parser::match_expression() const
  3156. {
  3157. auto type = m_state.current_token.type();
  3158. if (type == TokenType::Import) {
  3159. auto lookahead_token = next_token();
  3160. return lookahead_token.type() == TokenType::Period || lookahead_token.type() == TokenType::ParenOpen;
  3161. }
  3162. return type == TokenType::BoolLiteral
  3163. || type == TokenType::NumericLiteral
  3164. || type == TokenType::BigIntLiteral
  3165. || type == TokenType::StringLiteral
  3166. || type == TokenType::TemplateLiteralStart
  3167. || type == TokenType::NullLiteral
  3168. || match_identifier()
  3169. || type == TokenType::PrivateIdentifier
  3170. || type == TokenType::Await
  3171. || type == TokenType::New
  3172. || type == TokenType::Class
  3173. || type == TokenType::CurlyOpen
  3174. || type == TokenType::BracketOpen
  3175. || type == TokenType::ParenOpen
  3176. || type == TokenType::Function
  3177. || type == TokenType::Async
  3178. || type == TokenType::This
  3179. || type == TokenType::Super
  3180. || type == TokenType::RegexLiteral
  3181. || type == TokenType::Slash // Wrongly recognized regex by lexer
  3182. || type == TokenType::SlashEquals // Wrongly recognized regex by lexer (/=a/ is a valid regex)
  3183. || type == TokenType::Yield
  3184. || match_unary_prefixed_expression();
  3185. }
  3186. bool Parser::match_unary_prefixed_expression() const
  3187. {
  3188. auto type = m_state.current_token.type();
  3189. return type == TokenType::PlusPlus
  3190. || type == TokenType::MinusMinus
  3191. || type == TokenType::ExclamationMark
  3192. || type == TokenType::Tilde
  3193. || type == TokenType::Plus
  3194. || type == TokenType::Minus
  3195. || type == TokenType::Typeof
  3196. || type == TokenType::Void
  3197. || type == TokenType::Delete;
  3198. }
  3199. bool Parser::match_secondary_expression(ForbiddenTokens forbidden) const
  3200. {
  3201. auto type = m_state.current_token.type();
  3202. if (!forbidden.allows(type))
  3203. return false;
  3204. return type == TokenType::Plus
  3205. || type == TokenType::PlusEquals
  3206. || type == TokenType::Minus
  3207. || type == TokenType::MinusEquals
  3208. || type == TokenType::Asterisk
  3209. || type == TokenType::AsteriskEquals
  3210. || type == TokenType::Slash
  3211. || type == TokenType::SlashEquals
  3212. || type == TokenType::Percent
  3213. || type == TokenType::PercentEquals
  3214. || type == TokenType::DoubleAsterisk
  3215. || type == TokenType::DoubleAsteriskEquals
  3216. || type == TokenType::Equals
  3217. || type == TokenType::EqualsEqualsEquals
  3218. || type == TokenType::ExclamationMarkEqualsEquals
  3219. || type == TokenType::EqualsEquals
  3220. || type == TokenType::ExclamationMarkEquals
  3221. || type == TokenType::GreaterThan
  3222. || type == TokenType::GreaterThanEquals
  3223. || type == TokenType::LessThan
  3224. || type == TokenType::LessThanEquals
  3225. || type == TokenType::ParenOpen
  3226. || type == TokenType::Period
  3227. || type == TokenType::BracketOpen
  3228. || (type == TokenType::PlusPlus && !m_state.current_token.trivia_contains_line_terminator())
  3229. || (type == TokenType::MinusMinus && !m_state.current_token.trivia_contains_line_terminator())
  3230. || type == TokenType::In
  3231. || type == TokenType::Instanceof
  3232. || type == TokenType::QuestionMark
  3233. || type == TokenType::Ampersand
  3234. || type == TokenType::AmpersandEquals
  3235. || type == TokenType::Pipe
  3236. || type == TokenType::PipeEquals
  3237. || type == TokenType::Caret
  3238. || type == TokenType::CaretEquals
  3239. || type == TokenType::ShiftLeft
  3240. || type == TokenType::ShiftLeftEquals
  3241. || type == TokenType::ShiftRight
  3242. || type == TokenType::ShiftRightEquals
  3243. || type == TokenType::UnsignedShiftRight
  3244. || type == TokenType::UnsignedShiftRightEquals
  3245. || type == TokenType::DoubleAmpersand
  3246. || type == TokenType::DoubleAmpersandEquals
  3247. || type == TokenType::DoublePipe
  3248. || type == TokenType::DoublePipeEquals
  3249. || type == TokenType::DoubleQuestionMark
  3250. || type == TokenType::DoubleQuestionMarkEquals
  3251. || type == TokenType::QuestionMarkPeriod;
  3252. }
  3253. bool Parser::match_statement() const
  3254. {
  3255. auto type = m_state.current_token.type();
  3256. return match_expression()
  3257. || type == TokenType::Return
  3258. || type == TokenType::Yield
  3259. || type == TokenType::Do
  3260. || type == TokenType::If
  3261. || type == TokenType::Throw
  3262. || type == TokenType::Try
  3263. || type == TokenType::While
  3264. || type == TokenType::With
  3265. || type == TokenType::For
  3266. || type == TokenType::CurlyOpen
  3267. || type == TokenType::Switch
  3268. || type == TokenType::Break
  3269. || type == TokenType::Continue
  3270. || type == TokenType::Var
  3271. || type == TokenType::Debugger
  3272. || type == TokenType::Semicolon;
  3273. }
  3274. bool Parser::match_export_or_import() const
  3275. {
  3276. auto type = m_state.current_token.type();
  3277. return type == TokenType::Export
  3278. || type == TokenType::Import;
  3279. }
  3280. bool Parser::match_declaration() const
  3281. {
  3282. auto type = m_state.current_token.type();
  3283. if (type == TokenType::Let && !m_state.strict_mode) {
  3284. return try_match_let_declaration();
  3285. }
  3286. if (type == TokenType::Async) {
  3287. auto lookahead_token = next_token();
  3288. return lookahead_token.type() == TokenType::Function && !lookahead_token.trivia_contains_line_terminator();
  3289. }
  3290. return type == TokenType::Function
  3291. || type == TokenType::Class
  3292. || type == TokenType::Const
  3293. || type == TokenType::Let;
  3294. }
  3295. Token Parser::next_token(size_t steps) const
  3296. {
  3297. Lexer lookahead_lexer = m_state.lexer;
  3298. Token lookahead_token;
  3299. while (steps > 0) {
  3300. lookahead_token = lookahead_lexer.next();
  3301. steps--;
  3302. }
  3303. return lookahead_token;
  3304. }
  3305. bool Parser::try_match_let_declaration() const
  3306. {
  3307. VERIFY(m_state.current_token.type() == TokenType::Let);
  3308. auto token_after = next_token();
  3309. if (token_after.is_identifier_name() && token_after.value() != "in"sv)
  3310. return true;
  3311. if (token_after.type() == TokenType::CurlyOpen || token_after.type() == TokenType::BracketOpen)
  3312. return true;
  3313. return false;
  3314. }
  3315. bool Parser::match_variable_declaration() const
  3316. {
  3317. auto type = m_state.current_token.type();
  3318. if (type == TokenType::Let && !m_state.strict_mode) {
  3319. return try_match_let_declaration();
  3320. }
  3321. return type == TokenType::Var
  3322. || type == TokenType::Let
  3323. || type == TokenType::Const;
  3324. }
  3325. bool Parser::match_identifier() const
  3326. {
  3327. if (m_state.current_token.type() == TokenType::EscapedKeyword) {
  3328. if (m_state.current_token.value() == "let"sv)
  3329. return !m_state.strict_mode;
  3330. if (m_state.current_token.value() == "yield"sv)
  3331. return !m_state.strict_mode && !m_state.in_generator_function_context;
  3332. if (m_state.current_token.value() == "await"sv)
  3333. return m_program_type != Program::Type::Module && !m_state.await_expression_is_valid && !m_state.in_class_static_init_block;
  3334. return true;
  3335. }
  3336. return m_state.current_token.type() == TokenType::Identifier
  3337. || m_state.current_token.type() == TokenType::Async
  3338. || (m_state.current_token.type() == TokenType::Let && !m_state.strict_mode)
  3339. || (m_state.current_token.type() == TokenType::Await && m_program_type != Program::Type::Module && !m_state.await_expression_is_valid && !m_state.in_class_static_init_block)
  3340. || (m_state.current_token.type() == TokenType::Yield && !m_state.in_generator_function_context && !m_state.strict_mode); // See note in Parser::parse_identifier().
  3341. }
  3342. bool Parser::match_identifier_name() const
  3343. {
  3344. return m_state.current_token.is_identifier_name();
  3345. }
  3346. bool Parser::match_property_key() const
  3347. {
  3348. auto type = m_state.current_token.type();
  3349. return match_identifier_name()
  3350. || type == TokenType::BracketOpen
  3351. || type == TokenType::StringLiteral
  3352. || type == TokenType::NumericLiteral
  3353. || type == TokenType::BigIntLiteral;
  3354. }
  3355. bool Parser::done() const
  3356. {
  3357. return match(TokenType::Eof);
  3358. }
  3359. Token Parser::consume()
  3360. {
  3361. auto old_token = m_state.current_token;
  3362. m_state.current_token = m_state.lexer.next();
  3363. // NOTE: This is the bare minimum needed to decide whether we might need an arguments object
  3364. // in a function expression or declaration. ("might" because the AST implements some further
  3365. // conditions from the spec that rule out the need for allocating one)
  3366. if (old_token.type() == TokenType::Identifier && old_token.value().is_one_of("arguments"sv, "eval"sv))
  3367. m_state.function_might_need_arguments_object = true;
  3368. return old_token;
  3369. }
  3370. void Parser::consume_or_insert_semicolon()
  3371. {
  3372. // Semicolon was found and will be consumed
  3373. if (match(TokenType::Semicolon)) {
  3374. consume();
  3375. return;
  3376. }
  3377. // Insert semicolon if...
  3378. // ...token is preceded by one or more newlines
  3379. if (m_state.current_token.trivia_contains_line_terminator())
  3380. return;
  3381. // ...token is a closing curly brace
  3382. if (match(TokenType::CurlyClose))
  3383. return;
  3384. // ...token is eof
  3385. if (match(TokenType::Eof))
  3386. return;
  3387. // No rule for semicolon insertion applies -> syntax error
  3388. expected("Semicolon");
  3389. }
  3390. Token Parser::consume_identifier()
  3391. {
  3392. if (match(TokenType::Identifier))
  3393. return consume(TokenType::Identifier);
  3394. if (match(TokenType::EscapedKeyword))
  3395. return consume(TokenType::EscapedKeyword);
  3396. // Note that 'let' is not a reserved keyword, but our lexer considers it such
  3397. // As it's pretty nice to have that (for syntax highlighting and such), we'll
  3398. // special-case it here instead.
  3399. if (match(TokenType::Let)) {
  3400. if (m_state.strict_mode)
  3401. syntax_error("'let' is not allowed as an identifier in strict mode");
  3402. return consume();
  3403. }
  3404. if (match(TokenType::Yield)) {
  3405. if (m_state.strict_mode || m_state.in_generator_function_context)
  3406. syntax_error("Identifier must not be a reserved word in strict mode ('yield')");
  3407. return consume();
  3408. }
  3409. if (match(TokenType::Await)) {
  3410. if (m_program_type == Program::Type::Module || m_state.await_expression_is_valid || m_state.in_class_static_init_block)
  3411. syntax_error("Identifier must not be a reserved word in modules ('await')");
  3412. return consume();
  3413. }
  3414. if (match(TokenType::Async))
  3415. return consume();
  3416. expected("Identifier");
  3417. return consume();
  3418. }
  3419. // https://tc39.es/ecma262/#prod-IdentifierReference
  3420. Token Parser::consume_identifier_reference()
  3421. {
  3422. if (match(TokenType::Identifier))
  3423. return consume(TokenType::Identifier);
  3424. if (match(TokenType::EscapedKeyword)) {
  3425. auto name = m_state.current_token.value();
  3426. if (m_state.strict_mode && (name == "let"sv || name == "yield"sv))
  3427. syntax_error(String::formatted("'{}' is not allowed as an identifier in strict mode", name));
  3428. if (m_program_type == Program::Type::Module && name == "await"sv)
  3429. syntax_error("'await' is not allowed as an identifier in module");
  3430. return consume();
  3431. }
  3432. // See note in Parser::parse_identifier().
  3433. if (match(TokenType::Let)) {
  3434. if (m_state.strict_mode)
  3435. syntax_error("'let' is not allowed as an identifier in strict mode");
  3436. return consume();
  3437. }
  3438. if (match(TokenType::Yield)) {
  3439. if (m_state.strict_mode)
  3440. syntax_error("Identifier reference may not be 'yield' in strict mode");
  3441. return consume();
  3442. }
  3443. if (match(TokenType::Await)) {
  3444. if (m_program_type == Program::Type::Module)
  3445. syntax_error("'await' is not allowed as an identifier in module");
  3446. return consume();
  3447. }
  3448. if (match(TokenType::Async))
  3449. return consume();
  3450. expected(Token::name(TokenType::Identifier));
  3451. return consume();
  3452. }
  3453. Token Parser::consume(TokenType expected_type)
  3454. {
  3455. if (!match(expected_type)) {
  3456. expected(Token::name(expected_type));
  3457. }
  3458. auto token = consume();
  3459. if (expected_type == TokenType::Identifier) {
  3460. if (m_state.strict_mode && is_strict_reserved_word(token.value()))
  3461. syntax_error(String::formatted("Identifier must not be a reserved word in strict mode ('{}')", token.value()));
  3462. }
  3463. return token;
  3464. }
  3465. Token Parser::consume_and_validate_numeric_literal()
  3466. {
  3467. auto is_unprefixed_octal_number = [](StringView value) {
  3468. return value.length() > 1 && value[0] == '0' && is_ascii_digit(value[1]);
  3469. };
  3470. auto literal_start = position();
  3471. auto token = consume(TokenType::NumericLiteral);
  3472. if (m_state.strict_mode && is_unprefixed_octal_number(token.value()))
  3473. syntax_error("Unprefixed octal number not allowed in strict mode", literal_start);
  3474. if (match_identifier_name() && m_state.current_token.trivia().is_empty())
  3475. syntax_error("Numeric literal must not be immediately followed by identifier");
  3476. return token;
  3477. }
  3478. void Parser::expected(char const* what)
  3479. {
  3480. auto message = m_state.current_token.message();
  3481. if (message.is_empty())
  3482. message = String::formatted("Unexpected token {}. Expected {}", m_state.current_token.name(), what);
  3483. syntax_error(message);
  3484. }
  3485. Position Parser::position() const
  3486. {
  3487. return {
  3488. m_state.current_token.line_number(),
  3489. m_state.current_token.line_column(),
  3490. m_state.current_token.offset(),
  3491. };
  3492. }
  3493. bool Parser::try_parse_arrow_function_expression_failed_at_position(Position const& position) const
  3494. {
  3495. auto it = m_token_memoizations.find(position);
  3496. if (it == m_token_memoizations.end())
  3497. return false;
  3498. return (*it).value.try_parse_arrow_function_expression_failed;
  3499. }
  3500. void Parser::set_try_parse_arrow_function_expression_failed_at_position(Position const& position, bool failed)
  3501. {
  3502. m_token_memoizations.set(position, { failed });
  3503. }
  3504. void Parser::syntax_error(String const& message, Optional<Position> position)
  3505. {
  3506. if (!position.has_value())
  3507. position = this->position();
  3508. m_state.errors.append({ message, position });
  3509. }
  3510. void Parser::save_state()
  3511. {
  3512. m_saved_state.append(m_state);
  3513. }
  3514. void Parser::load_state()
  3515. {
  3516. VERIFY(!m_saved_state.is_empty());
  3517. m_state = m_saved_state.take_last();
  3518. }
  3519. void Parser::discard_saved_state()
  3520. {
  3521. m_saved_state.take_last();
  3522. }
  3523. void Parser::check_identifier_name_for_assignment_validity(FlyString const& name, bool force_strict)
  3524. {
  3525. // FIXME: this is now called from multiple places maybe the error message should be dynamic?
  3526. if (any_of(s_reserved_words, [&](auto& value) { return name == value; })) {
  3527. syntax_error("Binding pattern target may not be a reserved word");
  3528. } else if (m_state.strict_mode || force_strict) {
  3529. if (name.is_one_of("arguments"sv, "eval"sv))
  3530. syntax_error("Binding pattern target may not be called 'arguments' or 'eval' in strict mode");
  3531. else if (is_strict_reserved_word(name))
  3532. syntax_error(String::formatted("Binding pattern target may not be called '{}' in strict mode", name));
  3533. }
  3534. }
  3535. bool Parser::match_assert_clause() const
  3536. {
  3537. return !m_state.current_token.trivia_contains_line_terminator() && m_state.current_token.original_value() == "assert"sv;
  3538. }
  3539. FlyString Parser::consume_string_value()
  3540. {
  3541. VERIFY(match(TokenType::StringLiteral));
  3542. auto string_token = consume();
  3543. FlyString value = parse_string_literal(string_token)->value();
  3544. // This also checks IsStringWellFormedUnicode which makes sure there is no unpaired surrogate
  3545. // Surrogates are at least 3 bytes
  3546. if (value.length() < 3)
  3547. return value;
  3548. Utf8View view { value.view().substring_view(value.length() - 3) };
  3549. VERIFY(view.length() <= 3);
  3550. auto codepoint = *view.begin();
  3551. if (Utf16View::is_high_surrogate(codepoint)) {
  3552. syntax_error("StringValue ending with unpaired high surrogate");
  3553. VERIFY(view.length() == 1);
  3554. }
  3555. return value;
  3556. }
  3557. // AssertClause, https://tc39.es/proposal-import-assertions/#prod-AssertClause
  3558. ModuleRequest Parser::parse_module_request()
  3559. {
  3560. // Does not include the 'from' since that is not always required.
  3561. if (!match(TokenType::StringLiteral)) {
  3562. expected("ModuleSpecifier (string)");
  3563. return ModuleRequest { "!!invalid!!" };
  3564. }
  3565. ModuleRequest request { consume_string_value() };
  3566. if (!match_assert_clause())
  3567. return request;
  3568. VERIFY(m_state.current_token.original_value() == "assert"sv);
  3569. consume(TokenType::Identifier);
  3570. consume(TokenType::CurlyOpen);
  3571. while (!done() && !match(TokenType::CurlyClose)) {
  3572. String key;
  3573. if (match(TokenType::StringLiteral)) {
  3574. key = parse_string_literal(m_state.current_token)->value().to_string();
  3575. consume();
  3576. } else if (match_identifier_name()) {
  3577. key = consume().value();
  3578. } else {
  3579. expected("IdentifierName or StringValue as AssertionKey");
  3580. consume();
  3581. }
  3582. consume(TokenType::Colon);
  3583. if (match(TokenType::StringLiteral)) {
  3584. for (auto& entries : request.assertions) {
  3585. if (entries.key == key)
  3586. syntax_error(String::formatted("Duplicate assertion clauses with name: {}", key));
  3587. }
  3588. request.add_assertion(move(key), parse_string_literal(m_state.current_token)->value().to_string());
  3589. }
  3590. consume(TokenType::StringLiteral);
  3591. if (match(TokenType::Comma))
  3592. consume(TokenType::Comma);
  3593. else
  3594. break;
  3595. }
  3596. consume(TokenType::CurlyClose);
  3597. return request;
  3598. }
  3599. static FlyString default_string_value = "default";
  3600. NonnullRefPtr<ImportStatement> Parser::parse_import_statement(Program& program)
  3601. {
  3602. // We use the extended syntax which adds:
  3603. // ImportDeclaration:
  3604. // import ImportClause FromClause [no LineTerminator here] AssertClause;
  3605. // import ModuleSpecifier [no LineTerminator here] AssertClause;
  3606. // From: https://tc39.es/proposal-import-assertions/#prod-ImportDeclaration
  3607. auto rule_start = push_start();
  3608. if (program.type() != Program::Type::Module)
  3609. syntax_error("Cannot use import statement outside a module");
  3610. consume(TokenType::Import);
  3611. if (match(TokenType::StringLiteral)) {
  3612. // import ModuleSpecifier ;
  3613. auto module_request = parse_module_request();
  3614. return create_ast_node<ImportStatement>({ m_source_code, rule_start.position(), position() }, move(module_request));
  3615. }
  3616. auto match_imported_binding = [&] {
  3617. return match_identifier() || match(TokenType::Yield) || match(TokenType::Await);
  3618. };
  3619. auto match_as = [&] {
  3620. return match(TokenType::Identifier) && m_state.current_token.original_value() == "as"sv;
  3621. };
  3622. bool continue_parsing = true;
  3623. struct ImportWithLocation {
  3624. ImportStatement::ImportEntry entry;
  3625. Position position;
  3626. };
  3627. Vector<ImportWithLocation> entries_with_location;
  3628. // import ImportClause FromClause ;
  3629. // ImportClause :
  3630. // ImportedDefaultBinding
  3631. // NameSpaceImport
  3632. // NamedImports
  3633. // ImportedDefaultBinding , NameSpaceImport
  3634. // ImportedDefaultBinding , NamedImports
  3635. if (match_imported_binding()) {
  3636. // ImportedDefaultBinding : ImportedBinding
  3637. auto id_position = position();
  3638. auto bound_name = consume().value();
  3639. entries_with_location.append({ { default_string_value, bound_name }, id_position });
  3640. if (match(TokenType::Comma)) {
  3641. consume(TokenType::Comma);
  3642. } else {
  3643. continue_parsing = false;
  3644. }
  3645. }
  3646. if (!continue_parsing) {
  3647. // skip the rest
  3648. } else if (match(TokenType::Asterisk)) {
  3649. // NameSpaceImport : * as ImportedBinding
  3650. consume(TokenType::Asterisk);
  3651. if (!match_as())
  3652. syntax_error(String::formatted("Unexpected token: {}", m_state.current_token.name()));
  3653. consume(TokenType::Identifier);
  3654. if (match_imported_binding()) {
  3655. auto namespace_position = position();
  3656. auto namespace_name = consume().value();
  3657. entries_with_location.append({ ImportStatement::ImportEntry({}, namespace_name, true), namespace_position });
  3658. } else {
  3659. syntax_error(String::formatted("Unexpected token: {}", m_state.current_token.name()));
  3660. }
  3661. } else if (match(TokenType::CurlyOpen)) {
  3662. // NamedImports :
  3663. // { ImportSpecifier ,_opt } (repeated any amount of times)
  3664. consume(TokenType::CurlyOpen);
  3665. while (!done() && !match(TokenType::CurlyClose)) {
  3666. if (match_identifier_name()) {
  3667. // ImportSpecifier : ImportedBinding
  3668. auto require_as = !match_imported_binding();
  3669. auto name_position = position();
  3670. auto name = consume().flystring_value();
  3671. if (match_as()) {
  3672. consume(TokenType::Identifier);
  3673. auto alias_position = position();
  3674. auto alias = consume_identifier().flystring_value();
  3675. check_identifier_name_for_assignment_validity(alias);
  3676. entries_with_location.append({ { name, alias }, alias_position });
  3677. } else if (require_as) {
  3678. syntax_error(String::formatted("Unexpected reserved word '{}'", name));
  3679. } else {
  3680. check_identifier_name_for_assignment_validity(name);
  3681. entries_with_location.append({ { name, name }, name_position });
  3682. }
  3683. } else if (match(TokenType::StringLiteral)) {
  3684. // ImportSpecifier : ModuleExportName as ImportedBinding
  3685. auto name = consume_string_value();
  3686. if (!match_as())
  3687. expected("as");
  3688. consume(TokenType::Identifier);
  3689. auto alias_position = position();
  3690. auto alias = consume_identifier().flystring_value();
  3691. check_identifier_name_for_assignment_validity(alias);
  3692. entries_with_location.append({ { move(name), alias }, alias_position });
  3693. } else {
  3694. expected("identifier");
  3695. break;
  3696. }
  3697. if (!match(TokenType::Comma))
  3698. break;
  3699. consume(TokenType::Comma);
  3700. }
  3701. consume(TokenType::CurlyClose);
  3702. } else {
  3703. expected("import clauses");
  3704. }
  3705. auto from_statement = consume(TokenType::Identifier).original_value();
  3706. if (from_statement != "from"sv)
  3707. syntax_error(String::formatted("Expected 'from' got {}", from_statement));
  3708. auto module_request = parse_module_request();
  3709. Vector<ImportStatement::ImportEntry> entries;
  3710. entries.ensure_capacity(entries_with_location.size());
  3711. for (auto& entry : entries_with_location) {
  3712. for (auto& import_statement : program.imports()) {
  3713. if (import_statement.has_bound_name(entry.entry.local_name))
  3714. syntax_error(String::formatted("Identifier '{}' already declared", entry.entry.local_name), entry.position);
  3715. }
  3716. for (auto& new_entry : entries) {
  3717. if (new_entry.local_name == entry.entry.local_name)
  3718. syntax_error(String::formatted("Identifier '{}' already declared", entry.entry.local_name), entry.position);
  3719. }
  3720. entries.append(move(entry.entry));
  3721. }
  3722. return create_ast_node<ImportStatement>({ m_source_code, rule_start.position(), position() }, move(module_request), move(entries));
  3723. }
  3724. NonnullRefPtr<ExportStatement> Parser::parse_export_statement(Program& program)
  3725. {
  3726. using ExportEntry = ExportStatement::ExportEntry;
  3727. // We use the extended syntax which adds:
  3728. // ExportDeclaration:
  3729. // export ExportFromClause FromClause [no LineTerminator here] AssertClause ;
  3730. // From: https://tc39.es/proposal-import-assertions/#prod-ExportDeclaration
  3731. auto rule_start = push_start();
  3732. if (program.type() != Program::Type::Module)
  3733. syntax_error("Cannot use export statement outside a module");
  3734. auto match_as = [&] {
  3735. return match(TokenType::Identifier) && m_state.current_token.original_value() == "as"sv;
  3736. };
  3737. auto match_from = [&] {
  3738. return match(TokenType::Identifier) && m_state.current_token.original_value() == "from"sv;
  3739. };
  3740. auto match_default = [&] {
  3741. return match(TokenType::Default) && m_state.current_token.original_value() == "default"sv;
  3742. };
  3743. consume(TokenType::Export);
  3744. struct EntryAndLocation {
  3745. ExportEntry entry;
  3746. Position position;
  3747. };
  3748. Vector<EntryAndLocation> entries_with_location;
  3749. RefPtr<ASTNode> expression = {};
  3750. bool is_default = false;
  3751. ModuleRequest from_specifier;
  3752. if (match_default()) {
  3753. is_default = true;
  3754. auto default_position = position();
  3755. consume(TokenType::Default);
  3756. FlyString local_name;
  3757. auto lookahead_token = next_token();
  3758. enum class MatchesFunctionDeclaration {
  3759. Yes,
  3760. No,
  3761. WithoutName,
  3762. };
  3763. // Note: For some reason the spec here has declaration which can have no name
  3764. // and the rest of the parser is just not setup for that. With these
  3765. // hacks below we get through most things but we should probably figure
  3766. // out a better solution. I have attempted to explain why/what these "hacks" do below.
  3767. // The summary is treat named declarations just as declarations and hack around unnamed
  3768. // declarations with expression see also SourceTextModule::initialize_environment.
  3769. // As far as I'm aware the only problem (which is a tricky one) is:
  3770. // `export default function() {}()`
  3771. // Since we parse this as an expression you are immediately allowed to call it
  3772. // which is incorrect and this should give a SyntaxError.
  3773. auto has_name = [&](Token const& token) {
  3774. if (token.type() != TokenType::ParenOpen)
  3775. return MatchesFunctionDeclaration::Yes;
  3776. return MatchesFunctionDeclaration::WithoutName;
  3777. };
  3778. auto match_function_declaration = [&] {
  3779. // Hack part 1.
  3780. // Match a function declaration with a name, since we have async and generator
  3781. // and asyncgenerator variants this is quite complicated.
  3782. auto current_type = m_state.current_token.type();
  3783. Lexer lookahead_lexer = m_state.lexer;
  3784. lookahead_lexer.next();
  3785. if (current_type == TokenType::Function) {
  3786. if (lookahead_token.type() == TokenType::Asterisk)
  3787. return has_name(lookahead_lexer.next()); // function * [name]
  3788. else
  3789. return has_name(lookahead_token); // function [name]
  3790. }
  3791. if (current_type == TokenType::Async) {
  3792. if (lookahead_token.type() != TokenType::Function)
  3793. return MatchesFunctionDeclaration::No;
  3794. if (lookahead_token.trivia_contains_line_terminator())
  3795. return MatchesFunctionDeclaration::No;
  3796. auto lookahead_two_token = lookahead_lexer.next();
  3797. if (lookahead_two_token.type() == TokenType::Asterisk)
  3798. return has_name(lookahead_lexer.next()); // async function * [name]
  3799. else
  3800. return has_name(lookahead_two_token); // async function [name]
  3801. }
  3802. return MatchesFunctionDeclaration::No;
  3803. };
  3804. if (auto matches_function = match_function_declaration(); matches_function != MatchesFunctionDeclaration::No) {
  3805. auto function_declaration = parse_function_node<FunctionDeclaration>(
  3806. (matches_function == MatchesFunctionDeclaration::WithoutName ? FunctionNodeParseOptions::HasDefaultExportName : 0)
  3807. | FunctionNodeParseOptions::CheckForFunctionAndName);
  3808. m_state.current_scope_pusher->add_declaration(function_declaration);
  3809. if (matches_function == MatchesFunctionDeclaration::WithoutName)
  3810. local_name = ExportStatement::local_name_for_default;
  3811. else
  3812. local_name = function_declaration->name();
  3813. expression = move(function_declaration);
  3814. } else if (match(TokenType::Class) && lookahead_token.type() != TokenType::CurlyOpen && lookahead_token.type() != TokenType::Extends) {
  3815. // Hack part 2.
  3816. // Attempt to detect classes with names only as those are declarations,
  3817. // this actually seems to cover all cases already.
  3818. auto class_expression = parse_class_declaration();
  3819. m_state.current_scope_pusher->add_declaration(class_expression);
  3820. local_name = class_expression->name();
  3821. expression = move(class_expression);
  3822. } else if (match_expression()) {
  3823. // Hack part 3.
  3824. // Even though the unnamed declarations look like expression we should
  3825. // not treat them as such and thus not consume a semicolon after them.
  3826. bool special_case_declaration_without_name = match(TokenType::Class) || match(TokenType::Function) || (match(TokenType::Async) && lookahead_token.type() == TokenType::Function && !lookahead_token.trivia_contains_line_terminator());
  3827. expression = parse_expression(2);
  3828. if (!special_case_declaration_without_name)
  3829. consume_or_insert_semicolon();
  3830. if (is<ClassExpression>(*expression)) {
  3831. auto const& class_expression = static_cast<ClassExpression&>(*expression);
  3832. if (class_expression.has_name())
  3833. local_name = class_expression.name();
  3834. }
  3835. } else {
  3836. expected("Declaration or assignment expression");
  3837. local_name = "!!invalid!!";
  3838. }
  3839. if (local_name.is_null()) {
  3840. local_name = ExportStatement::local_name_for_default;
  3841. }
  3842. entries_with_location.append({ ExportEntry::named_export(default_string_value, move(local_name)), default_position });
  3843. } else {
  3844. enum class FromSpecifier {
  3845. NotAllowed,
  3846. Optional,
  3847. Required
  3848. } check_for_from { FromSpecifier::NotAllowed };
  3849. auto parse_module_export_name = [&](bool lhs) -> FlyString {
  3850. // https://tc39.es/ecma262/#prod-ModuleExportName
  3851. // ModuleExportName :
  3852. // IdentifierName
  3853. // StringLiteral
  3854. if (match_identifier_name()) {
  3855. return consume().value();
  3856. }
  3857. if (match(TokenType::StringLiteral)) {
  3858. // It is a Syntax Error if ReferencedBindings of NamedExports contains any StringLiterals.
  3859. // Only for export { "a" as "b" }; // <-- no from
  3860. if (lhs)
  3861. check_for_from = FromSpecifier::Required;
  3862. return consume_string_value();
  3863. }
  3864. expected("ExportSpecifier (string or identifier)");
  3865. return {};
  3866. };
  3867. if (match(TokenType::Asterisk)) {
  3868. auto asterisk_position = position();
  3869. consume(TokenType::Asterisk);
  3870. if (match_as()) {
  3871. // * as ModuleExportName
  3872. consume(TokenType::Identifier);
  3873. auto namespace_position = position();
  3874. auto exported_name = parse_module_export_name(false);
  3875. entries_with_location.append({ ExportEntry::all_module_request(exported_name), namespace_position });
  3876. } else {
  3877. entries_with_location.append({ ExportEntry::all_but_default_entry(), asterisk_position });
  3878. }
  3879. check_for_from = FromSpecifier::Required;
  3880. } else if (match_declaration()) {
  3881. auto decl_position = position();
  3882. auto declaration = parse_declaration();
  3883. m_state.current_scope_pusher->add_declaration(declaration);
  3884. if (is<FunctionDeclaration>(*declaration)) {
  3885. auto& func = static_cast<FunctionDeclaration&>(*declaration);
  3886. entries_with_location.append({ ExportEntry::named_export(func.name(), func.name()), func.source_range().start });
  3887. } else if (is<ClassDeclaration>(*declaration)) {
  3888. auto& class_declaration = static_cast<ClassDeclaration&>(*declaration);
  3889. entries_with_location.append({ ExportEntry::named_export(class_declaration.name(), class_declaration.name()), class_declaration.source_range().start });
  3890. } else {
  3891. VERIFY(is<VariableDeclaration>(*declaration));
  3892. auto& variables = static_cast<VariableDeclaration&>(*declaration);
  3893. VERIFY(variables.is_lexical_declaration());
  3894. for (auto& decl : variables.declarations()) {
  3895. decl.target().visit(
  3896. [&](NonnullRefPtr<Identifier> const& identifier) {
  3897. entries_with_location.append({ ExportEntry::named_export(identifier->string(), identifier->string()), identifier->source_range().start });
  3898. },
  3899. [&](NonnullRefPtr<BindingPattern> const& binding) {
  3900. binding->for_each_bound_name([&](auto& name) {
  3901. entries_with_location.append({ ExportEntry::named_export(name, name), decl_position });
  3902. });
  3903. });
  3904. }
  3905. }
  3906. expression = declaration;
  3907. } else if (match(TokenType::Var)) {
  3908. auto variable_position = position();
  3909. auto variable_declaration = parse_variable_declaration();
  3910. m_state.current_scope_pusher->add_declaration(variable_declaration);
  3911. for (auto& decl : variable_declaration->declarations()) {
  3912. decl.target().visit(
  3913. [&](NonnullRefPtr<Identifier> const& identifier) {
  3914. entries_with_location.append({ ExportEntry::named_export(identifier->string(), identifier->string()), identifier->source_range().start });
  3915. },
  3916. [&](NonnullRefPtr<BindingPattern> const& binding) {
  3917. binding->for_each_bound_name([&](auto& name) {
  3918. entries_with_location.append({ ExportEntry::named_export(name, name), variable_position });
  3919. });
  3920. });
  3921. }
  3922. expression = variable_declaration;
  3923. } else if (match(TokenType::CurlyOpen)) {
  3924. consume(TokenType::CurlyOpen);
  3925. check_for_from = FromSpecifier::Optional;
  3926. // FIXME: Even when empty should add module to requiredModules!
  3927. while (!done() && !match(TokenType::CurlyClose)) {
  3928. auto identifier_position = position();
  3929. auto identifier = parse_module_export_name(true);
  3930. if (match_as()) {
  3931. consume(TokenType::Identifier);
  3932. auto export_name = parse_module_export_name(false);
  3933. entries_with_location.append({ ExportEntry::named_export(move(export_name), move(identifier)), identifier_position });
  3934. } else {
  3935. entries_with_location.append({ ExportEntry::named_export(identifier, identifier), identifier_position });
  3936. }
  3937. if (!match(TokenType::Comma))
  3938. break;
  3939. consume(TokenType::Comma);
  3940. }
  3941. if (entries_with_location.is_empty()) {
  3942. // export {} from "module"; Since this will never be a
  3943. // duplicate we can give a slightly wrong location.
  3944. entries_with_location.append({ ExportEntry::empty_named_export(), position() });
  3945. }
  3946. consume(TokenType::CurlyClose);
  3947. } else {
  3948. syntax_error("Unexpected token 'export'", rule_start.position());
  3949. }
  3950. if (check_for_from != FromSpecifier::NotAllowed && match_from()) {
  3951. consume(TokenType::Identifier);
  3952. from_specifier = parse_module_request();
  3953. } else if (check_for_from == FromSpecifier::Required) {
  3954. expected("from");
  3955. }
  3956. if (check_for_from != FromSpecifier::NotAllowed)
  3957. consume_or_insert_semicolon();
  3958. }
  3959. Vector<ExportStatement::ExportEntry> entries;
  3960. entries.ensure_capacity(entries_with_location.size());
  3961. for (auto& entry : entries_with_location) {
  3962. for (auto& export_statement : program.exports()) {
  3963. if (export_statement.has_export(entry.entry.export_name))
  3964. syntax_error(String::formatted("Duplicate export with name: '{}'", entry.entry.export_name), entry.position);
  3965. }
  3966. for (auto& new_entry : entries) {
  3967. if (new_entry.kind != ExportStatement::ExportEntry::Kind::EmptyNamedExport && new_entry.export_name == entry.entry.export_name)
  3968. syntax_error(String::formatted("Duplicate export with name: '{}'", entry.entry.export_name), entry.position);
  3969. }
  3970. entries.append(move(entry.entry));
  3971. }
  3972. return create_ast_node<ExportStatement>({ m_source_code, rule_start.position(), position() }, move(expression), move(entries), is_default, move(from_specifier));
  3973. }
  3974. Parser::ForbiddenTokens::ForbiddenTokens(std::initializer_list<TokenType> const& forbidden)
  3975. {
  3976. forbid_tokens(forbidden);
  3977. }
  3978. void Parser::ForbiddenTokens::forbid_tokens(std::initializer_list<TokenType> const& forbidden)
  3979. {
  3980. for (auto token : forbidden) {
  3981. switch (token) {
  3982. case TokenType::In:
  3983. m_forbid_in_token = true;
  3984. break;
  3985. case TokenType::DoubleAmpersand:
  3986. case TokenType::DoublePipe:
  3987. m_forbid_logical_tokens = true;
  3988. break;
  3989. case TokenType::DoubleQuestionMark:
  3990. m_forbid_coalesce_token = true;
  3991. break;
  3992. case TokenType::QuestionMarkPeriod:
  3993. m_forbid_question_mark_period = true;
  3994. break;
  3995. case TokenType::ParenOpen:
  3996. m_forbid_paren_open = true;
  3997. break;
  3998. case TokenType::Equals:
  3999. m_forbid_equals = true;
  4000. break;
  4001. default:
  4002. VERIFY_NOT_REACHED();
  4003. }
  4004. }
  4005. }
  4006. bool Parser::ForbiddenTokens::allows(TokenType token) const
  4007. {
  4008. switch (token) {
  4009. case TokenType::In:
  4010. return !m_forbid_in_token;
  4011. case TokenType::DoubleAmpersand:
  4012. case TokenType::DoublePipe:
  4013. return !m_forbid_logical_tokens;
  4014. case TokenType::DoubleQuestionMark:
  4015. return !m_forbid_coalesce_token;
  4016. case TokenType::QuestionMarkPeriod:
  4017. return !m_forbid_question_mark_period;
  4018. case TokenType::ParenOpen:
  4019. return !m_forbid_paren_open;
  4020. case TokenType::Equals:
  4021. return !m_forbid_equals;
  4022. default:
  4023. return true;
  4024. }
  4025. }
  4026. Parser::ForbiddenTokens Parser::ForbiddenTokens::merge(ForbiddenTokens other) const
  4027. {
  4028. ForbiddenTokens result = *this;
  4029. result.m_forbid_in_token |= other.m_forbid_in_token;
  4030. result.m_forbid_logical_tokens |= other.m_forbid_logical_tokens;
  4031. result.m_forbid_coalesce_token |= other.m_forbid_coalesce_token;
  4032. result.m_forbid_paren_open |= other.m_forbid_paren_open;
  4033. result.m_forbid_question_mark_period |= other.m_forbid_question_mark_period;
  4034. result.m_forbid_equals |= other.m_forbid_equals;
  4035. return result;
  4036. }
  4037. Parser::ForbiddenTokens Parser::ForbiddenTokens::forbid(std::initializer_list<TokenType> const& forbidden) const
  4038. {
  4039. ForbiddenTokens result = *this;
  4040. result.forbid_tokens(forbidden);
  4041. return result;
  4042. }
  4043. template NonnullRefPtr<FunctionExpression> Parser::parse_function_node(u16, Optional<Position> const&);
  4044. template NonnullRefPtr<FunctionDeclaration> Parser::parse_function_node(u16, Optional<Position> const&);
  4045. }