blob: e006a09e659d019eb045a92bc5dd11dbc1c11c54 [file] [log] [blame]
// Copyright 2018 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "third_party/blink/renderer/core/core_export.h"
namespace blink {
class ScriptState;
class ScriptWrappable;
// Objects which
// a) directly or indirectly own V8 objects held via TraceWrapperV8References,
// and
// b) are constructed via the bindings
// need to call this function at the start of the constructor to ensure that a
// wrapper object exists for V8 to trace through. This ensures that the
// TraceWrapperV8Reference will not be collected even if a GC takes place during
// construction.
// This function posts a task containing a strong reference. The reference
// remains until the task is executed. This is slightly longer than necessary,
// but it shouldn't matter in practice.
// This function returns false if it fails. Usually this means the task runner
// is in the process of being destroyed. The caller must ensure that the
// reference is not used in this case.
// TODO(yhirano): Remove this once the unified GC is available.
bool CORE_EXPORT RetainWrapperDuringConstruction(ScriptWrappable*,
} // namespace blink