| /* |
| * Copyright (C) 2010 Google, Inc. All Rights Reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in the |
| * documentation and/or other materials provided with the distribution. |
| * |
| * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY |
| * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
| * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR |
| * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
| * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
| * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
| * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY |
| * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| #ifndef HTMLParserScriptRunner_h |
| #define HTMLParserScriptRunner_h |
| |
| #include "bindings/core/v8/ScriptStreamer.h" |
| #include "core/dom/PendingScript.h" |
| #include "core/html/parser/HTMLParserReentryPermit.h" |
| #include "platform/heap/Handle.h" |
| #include "platform/loader/fetch/ResourceClient.h" |
| #include "wtf/Deque.h" |
| #include "wtf/RefPtr.h" |
| #include "wtf/text/TextPosition.h" |
| |
| namespace blink { |
| |
| class Document; |
| class Element; |
| class HTMLParserScriptRunnerHost; |
| |
| // HTMLParserScriptRunner is responsible for for arranging the execution of |
| // script elements inserted by the parser, according to the rules for |
| // 'An end tag whose tag name is "script"': |
| // https://html.spec.whatwg.org/multipage/syntax.html#scriptEndTag |
| // |
| // If a script blocks parsing, this class is responsible for holding it, and |
| // executing it when required. |
| // |
| // An HTMLParserScriptRunner is owned by its host, an HTMLDocumentParser. |
| class HTMLParserScriptRunner final |
| : public GarbageCollectedFinalized<HTMLParserScriptRunner>, |
| private PendingScriptClient { |
| WTF_MAKE_NONCOPYABLE(HTMLParserScriptRunner); |
| USING_GARBAGE_COLLECTED_MIXIN(HTMLParserScriptRunner); |
| USING_PRE_FINALIZER(HTMLParserScriptRunner, detach); |
| |
| public: |
| static HTMLParserScriptRunner* create(HTMLParserReentryPermit* reentryPermit, |
| Document* document, |
| HTMLParserScriptRunnerHost* host) { |
| return new HTMLParserScriptRunner(reentryPermit, document, host); |
| } |
| ~HTMLParserScriptRunner(); |
| |
| // Prepares this object to be destroyed. Invoked when the parser is detached, |
| // or failing that, as a pre-finalizer. |
| void detach(); |
| |
| // Processes the passed in script and any pending scripts if possible. |
| // This does not necessarily run the script immediately. For instance, |
| // execution may not happen until the script loads from the network, or after |
| // the document finishes parsing. |
| void processScriptElement(Element*, const TextPosition& scriptStartPosition); |
| |
| // Invoked when the parsing-blocking script resource has loaded, to execute |
| // parsing-blocking scripts. |
| void executeScriptsWaitingForLoad(PendingScript*); |
| |
| // Invoked when all script-blocking resources (e.g., stylesheets) have loaded, |
| // to execute parsing-blocking scripts. |
| void executeScriptsWaitingForResources(); |
| |
| // Invoked when parsing is stopping, to execute any deferred scripts. |
| bool executeScriptsWaitingForParsing(); |
| |
| bool hasParserBlockingScript() const; |
| bool isExecutingScript() const { |
| return !!m_reentryPermit->scriptNestingLevel(); |
| } |
| |
| DECLARE_TRACE(); |
| |
| private: |
| HTMLParserScriptRunner(HTMLParserReentryPermit*, |
| Document*, |
| HTMLParserScriptRunnerHost*); |
| |
| // PendingScriptClient |
| void pendingScriptFinished(PendingScript*) override; |
| |
| void executePendingScriptAndDispatchEvent(PendingScript*, |
| ScriptStreamer::Type); |
| void executeParsingBlockingScripts(); |
| |
| void requestParsingBlockingScript(Element*); |
| void requestDeferredScript(Element*); |
| PendingScript* requestPendingScript(Element*) const; |
| |
| // Processes the provided script element, but does not execute any |
| // parsing-blocking scripts that may remain after execution. |
| void processScriptElementInternal(Element*, |
| const TextPosition& scriptStartPosition); |
| |
| const PendingScript* parserBlockingScript() const { |
| return m_parserBlockingScript; |
| } |
| |
| bool isParserBlockingScriptReady(); |
| |
| void possiblyFetchBlockedDocWriteScript(PendingScript*); |
| |
| RefPtr<HTMLParserReentryPermit> m_reentryPermit; |
| Member<Document> m_document; |
| Member<HTMLParserScriptRunnerHost> m_host; |
| |
| // https://html.spec.whatwg.org/#pending-parsing-blocking-script |
| Member<PendingScript> m_parserBlockingScript; |
| |
| // https://html.spec.whatwg.org/#list-of-scripts-that-will-execute-when-the-document-has-finished-parsing |
| HeapDeque<Member<PendingScript>> m_scriptsToExecuteAfterParsing; |
| }; |
| |
| } // namespace blink |
| |
| #endif |