15c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)/* 25c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Copyright (C) 2012 Google Inc. All rights reserved. 35c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 45c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Redistribution and use in source and binary forms, with or without 55c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * modification, are permitted provided that the following conditions are 65c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * met: 75c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 85c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * * Redistributions of source code must retain the above copyright 95c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * notice, this list of conditions and the following disclaimer. 105c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * * Redistributions in binary form must reproduce the above 115c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * copyright notice, this list of conditions and the following disclaimer 125c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * in the documentation and/or other materials provided with the 135c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * distribution. 145c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * * Neither the name of Google Inc. nor the names of its 155c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * contributors may be used to endorse or promote products derived from 165c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * this software without specific prior written permission. 175c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 185c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 195c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 205c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 215c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 225c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 235c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 245c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 255c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 265c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 275c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 285c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 295c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) */ 305c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 315267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)#ifndef WebScopedMicrotaskSuppression_h 325267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)#define WebScopedMicrotaskSuppression_h 335c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 345267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)#include "../platform/WebPrivateOwnPtr.h" 355c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 3651b2906e11752df6c18351cf520e30522d3b53a1Torne (Richard Coles)namespace blink { 375c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 385267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// This class wraps V8RecursionScope::BypassMicrotaskCheckpoint. Please 395267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// see V8RecursionScope.h for full usage. Short story: Embedder calls into 405267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// script contexts which also host page script must do one of two things: 415267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// 425267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// 1. If the call may cause any page/author script to run, it must be 435267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// captured for pre/post work (e.g. inspector instrumentation/microtask 445267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// delivery) and thus be invoked through WebFrame (e.g. executeScript*, 455267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// callFunction*). 465267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// 2. If the call will not cause any page/author script to run, the call 475267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// should be made directly via the v8 context, but the callsite must be 485267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// accompanied by a stack allocated WebScopedMicrotaskSuppression, e.g.: 495267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// 505267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// ... 515267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// { 5251b2906e11752df6c18351cf520e30522d3b53a1Torne (Richard Coles)// blink::WebScopedMicrotaskSuppression suppression; 535267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// func->Call(global, argv, args); 545267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// } 555267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// ... 565267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)// 575267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)class WebScopedMicrotaskSuppression { 585c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)public: 595267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) WebScopedMicrotaskSuppression() { initialize(); } 605267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) ~WebScopedMicrotaskSuppression() { reset(); } 615c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 625c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)private: 6306f816c7c76bc45a15e452ade8a34e8af077693eTorne (Richard Coles) BLINK_EXPORT void initialize(); 6406f816c7c76bc45a15e452ade8a34e8af077693eTorne (Richard Coles) BLINK_EXPORT void reset(); 655c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 66197021e6b966cfb06891637935ef33fff06433d1Ben Murdoch // Always declare this data member. When assertions are on in 67197021e6b966cfb06891637935ef33fff06433d1Ben Murdoch // Release builds of Blink, this header may be included from 68197021e6b966cfb06891637935ef33fff06433d1Ben Murdoch // Chromium with different preprocessor options than used when 69197021e6b966cfb06891637935ef33fff06433d1Ben Murdoch // building Blink itself. 705267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) class Impl; 715267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) WebPrivateOwnPtr<Impl> m_impl; 725267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)}; 735c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 745267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)} // WebKit 755c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 765267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)#endif 77