text: /*
   * Copyright (C) 2019 Apple 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. AND ITS CONTRIBUTORS ``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 ITS 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.
   */
  
  #pragma once
  
  #include "InspectorAgentBase.h"
  #include "InspectorBackendDispatchers.h"
  #include "JSCInlines.h"
  #include <wtf/FastMalloc.h>
  #include <wtf/Forward.h>
  #include <wtf/Noncopyable.h>
  
  namespace Inspector {
  
  class InjectedScript;
  class InjectedScriptManager;
  class ScriptDebugServer;
  typedef String ErrorString;
  
  class JS_EXPORT_PRIVATE InspectorAuditAgent : public InspectorAgentBase, public AuditBackendDispatcherHandler {
      WTF_MAKE_NONCOPYABLE(InspectorAuditAgent);
      WTF_MAKE_FAST_ALLOCATED;
  public:
      virtual ~InspectorAuditAgent() = default;
  
      // InspectorAgentBase
      void didCreateFrontendAndBackend(FrontendRouter*, BackendDispatcher*) override;
      void willDestroyFrontendAndBackend(DisconnectReason) override;
  
      // AuditBackendDispatcherHandler
      void setup(ErrorString&, const int* executionContextId) final;
      void run(ErrorString&, const String& test, const int* executionContextId, RefPtr<Protocol::Runtime::RemoteObject>& result, Optional<bool>& wasThrown) final;
      void teardown(ErrorString&) final;
  
      bool hasActiveAudit() const;
  
  protected:
      explicit InspectorAuditAgent(AgentContext&);
  
      InjectedScriptManager& injectedScriptManager() { return m_injectedScriptManager; }
  
      virtual InjectedScript injectedScriptForEval(ErrorString&, const int* executionContextId) = 0;
  
      virtual void populateAuditObject(JSC::ExecState*, JSC::Strong<JSC::JSObject>& /* auditObject */) { };
  
      virtual void muteConsole() { };
      virtual void unmuteConsole() { };
  
  private:
      RefPtr<AuditBackendDispatcher> m_backendDispatcher;
      InjectedScriptManager& m_injectedScriptManager;
      ScriptDebugServer& m_scriptDebugServer;
  
      JSC::Strong<JSC::JSObject> m_injectedWebInspectorAuditValue;
  };
  
  } // namespace Inspector
  