gin/public/isolate_holder.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef GIN_PUBLIC_ISOLATE_HOLDER_H_
   6 #define GIN_PUBLIC_ISOLATE_HOLDER_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/memory/scoped_ptr.h"
  10 #include "gin/gin_export.h"
  11 #include "v8/include/v8.h"
  12
  13 namespace gin {
  14
  15 class PerIsolateData;
  16
  17 // To embed Gin, first initialize gin using IsolateHolder::Initialize and then
  18 // create an instance of IsolateHolder to hold the v8::Isolate in which you
  19 // will execute JavaScript. You might wish to subclass IsolateHolder if you
  20 // want to tie more state to the lifetime of the isolate.
  21 class GIN_EXPORT IsolateHolder {
  22  public:
  23   // Controls whether or not V8 should only accept strict mode scripts.
  24   enum ScriptMode {
  25     kNonStrictMode,
  26     kStrictMode
  27   };
  28
  29   IsolateHolder();
  30   ~IsolateHolder();
  31
  32   // Should be invoked once before creating IsolateHolder instances to
  33   // initialize V8 and Gin.
  34   static void Initialize(ScriptMode mode,
  35                          v8::ArrayBuffer::Allocator* allocator);
  36
  37   v8::Isolate* isolate() { return isolate_; }
  38
  39  private:
  40   v8::Isolate* isolate_;
  41   scoped_ptr<PerIsolateData> isolate_data_;
  42
  43   DISALLOW_COPY_AND_ASSIGN(IsolateHolder);
  44 };
  45
  46 }  // namespace gin
  47
  48 #endif  // GIN_PUBLIC_ISOLATE_HOLDER_H_