664f7bea8a48fc3cadeace233c4a05411a0ca270
[WebKit-https.git] / JavaScriptCore / API / JSContextRef.cpp
1 /*
2  * Copyright (C) 2006, 2007 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
24  */
25
26 #include "config.h"
27 #include "JSContextRef.h"
28 #include "JSContextRefPrivate.h"
29
30 #include "APICast.h"
31 #include "InitializeThreading.h"
32 #include "JSCallbackObject.h"
33 #include "JSClassRef.h"
34 #include "JSGlobalObject.h"
35 #include "JSObject.h"
36
37 #if OS(DARWIN)
38 #include <mach-o/dyld.h>
39
40 static const int32_t webkitFirstVersionWithConcurrentGlobalContexts = 0x2100500; // 528.5.0
41 #endif
42
43 using namespace JSC;
44
45 JSContextGroupRef JSContextGroupCreate()
46 {
47     initializeThreading();
48     return toRef(JSGlobalData::createNonDefault().releaseRef());
49 }
50
51 JSContextGroupRef JSContextGroupRetain(JSContextGroupRef group)
52 {
53     toJS(group)->ref();
54     return group;
55 }
56
57 void JSContextGroupRelease(JSContextGroupRef group)
58 {
59     toJS(group)->deref();
60 }
61
62 JSGlobalContextRef JSGlobalContextCreate(JSClassRef globalObjectClass)
63 {
64     initializeThreading();
65 #if OS(DARWIN)
66     // When running on Tiger or Leopard, or if the application was linked before JSGlobalContextCreate was changed
67     // to use a unique JSGlobalData, we use a shared one for compatibility.
68 #if !defined(BUILDING_ON_TIGER) && !defined(BUILDING_ON_LEOPARD)
69     if (NSVersionOfLinkTimeLibrary("JavaScriptCore") <= webkitFirstVersionWithConcurrentGlobalContexts) {
70 #else
71     {
72 #endif
73         JSLock lock(LockForReal);
74         return JSGlobalContextCreateInGroup(toRef(&JSGlobalData::sharedInstance()), globalObjectClass);
75     }
76 #endif // OS(DARWIN)
77
78     return JSGlobalContextCreateInGroup(0, globalObjectClass);
79 }
80
81 JSGlobalContextRef JSGlobalContextCreateInGroup(JSContextGroupRef group, JSClassRef globalObjectClass)
82 {
83     initializeThreading();
84
85     JSLock lock(LockForReal);
86     RefPtr<JSGlobalData> globalData = group ? PassRefPtr<JSGlobalData>(toJS(group)) : JSGlobalData::createNonDefault();
87
88     APIEntryShim entryShim(globalData.get(), false);
89
90 #if ENABLE(JSC_MULTIPLE_THREADS)
91     globalData->makeUsableFromMultipleThreads();
92 #endif
93
94     if (!globalObjectClass) {
95         JSGlobalObject* globalObject = new (globalData.get()) JSGlobalObject;
96         return JSGlobalContextRetain(toGlobalRef(globalObject->globalExec()));
97     }
98
99     JSGlobalObject* globalObject = new (globalData.get()) JSCallbackObject<JSGlobalObject>(globalObjectClass);
100     ExecState* exec = globalObject->globalExec();
101     JSValue prototype = globalObjectClass->prototype(exec);
102     if (!prototype)
103         prototype = jsNull();
104     globalObject->resetPrototype(prototype);
105     return JSGlobalContextRetain(toGlobalRef(exec));
106 }
107
108 JSGlobalContextRef JSGlobalContextRetain(JSGlobalContextRef ctx)
109 {
110     ExecState* exec = toJS(ctx);
111     APIEntryShim entryShim(exec);
112
113     JSGlobalData& globalData = exec->globalData();
114     gcProtect(exec->dynamicGlobalObject());
115     globalData.ref();
116     return ctx;
117 }
118
119 void JSGlobalContextRelease(JSGlobalContextRef ctx)
120 {
121     ExecState* exec = toJS(ctx);
122     JSLock lock(exec);
123
124     JSGlobalData& globalData = exec->globalData();
125     JSGlobalObject* dgo = exec->dynamicGlobalObject();
126     IdentifierTable* savedIdentifierTable = wtfThreadData().setCurrentIdentifierTable(globalData.identifierTable);
127
128     // One reference is held by JSGlobalObject, another added by JSGlobalContextRetain().
129     bool releasingContextGroup = globalData.refCount() == 2;
130     bool releasingGlobalObject = Heap::heap(dgo)->unprotect(dgo);
131     // If this is the last reference to a global data, it should also
132     // be the only remaining reference to the global object too!
133     ASSERT(!releasingContextGroup || releasingGlobalObject);
134
135     // An API 'JSGlobalContextRef' retains two things - a global object and a
136     // global data (or context group, in API terminology).
137     // * If this is the last reference to any contexts in the given context group,
138     //   call destroy on the heap (the global data is being  freed).
139     // * If this was the last reference to the global object, then unprotecting
140     //   it may  release a lot of GC memory - run the garbage collector now.
141     // * If there are more references remaining the the global object, then do nothing
142     //   (specifically that is more protects, which we assume come from other JSGlobalContextRefs).
143     if (releasingContextGroup)
144         globalData.heap.destroy();
145     else if (releasingGlobalObject)
146         globalData.heap.collectAllGarbage();
147
148     globalData.deref();
149
150     wtfThreadData().setCurrentIdentifierTable(savedIdentifierTable);
151 }
152
153 JSObjectRef JSContextGetGlobalObject(JSContextRef ctx)
154 {
155     ExecState* exec = toJS(ctx);
156     APIEntryShim entryShim(exec);
157
158     // It is necessary to call toThisObject to get the wrapper object when used with WebCore.
159     return toRef(exec->lexicalGlobalObject()->toThisObject(exec));
160 }
161
162 JSContextGroupRef JSContextGetGroup(JSContextRef ctx)
163 {
164     ExecState* exec = toJS(ctx);
165     return toRef(&exec->globalData());
166 }
167
168 JSGlobalContextRef JSContextGetGlobalContext(JSContextRef ctx)
169 {
170     ExecState* exec = toJS(ctx);
171     APIEntryShim entryShim(exec);
172
173     return toGlobalRef(exec->lexicalGlobalObject()->globalExec());
174 }