summaryrefslogtreecommitdiffstats
path: root/gin/public/isolate_holder.h
blob: f82a53ac2fbcdbe5efb5baf25248e956ee708385 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
// Copyright 2013 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.

#ifndef GIN_PUBLIC_ISOLATE_HOLDER_H_
#define GIN_PUBLIC_ISOLATE_HOLDER_H_

#include "base/basictypes.h"
#include "base/memory/scoped_ptr.h"
#include "gin/gin_export.h"
#include "v8/include/v8.h"

namespace gin {

class PerIsolateData;

// To embed Gin, first create an instance of IsolateHolder to hold the
// v8::Isolate in which you will execute JavaScript. You might wish to subclass
// IsolateHolder if you want to tie more state to the lifetime of the
//
// You can use gin in two modes: either gin manages V8, or the gin-embedder
// manages gin. If gin manages V8, use the IsolateHolder constructor without
// parameters, otherwise, the gin-embedder needs to create v8::Isolates and
// pass them to IsolateHolder.
//
// It is not possible to mix the two.
class GIN_EXPORT IsolateHolder {
 public:
  // Controls whether or not V8 should only accept strict mode scripts.
  enum ScriptMode {
    kNonStrictMode,
    kStrictMode
  };

  explicit IsolateHolder(ScriptMode mode);
  IsolateHolder(v8::Isolate* isolate, v8::ArrayBuffer::Allocator* allocator);

  ~IsolateHolder();

  v8::Isolate* isolate() { return isolate_; }

 private:
  void Init(v8::ArrayBuffer::Allocator* allocator);

  bool isolate_owner_;
  v8::Isolate* isolate_;
  scoped_ptr<PerIsolateData> isolate_data_;

  DISALLOW_COPY_AND_ASSIGN(IsolateHolder);
};

}  // namespace gin

#endif  // GIN_PUBLIC_ISOLATE_HOLDER_H_