OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2006 Apple Computer, Inc. All rights reserved. | 2 * Copyright (C) 2006 Apple Computer, Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions | 5 * modification, are permitted provided that the following conditions |
6 * are met: | 6 * are met: |
7 * 1. Redistributions of source code must retain the above copyright | 7 * 1. Redistributions of source code must retain the above copyright |
8 * notice, this list of conditions and the following disclaimer. | 8 * notice, this list of conditions and the following disclaimer. |
9 * 2. Redistributions in binary form must reproduce the above copyright | 9 * 2. Redistributions in binary form must reproduce the above copyright |
10 * notice, this list of conditions and the following disclaimer in the | 10 * notice, this list of conditions and the following disclaimer in the |
(...skipping 30 matching lines...) Expand all Loading... |
41 /*! | 41 /*! |
42 @function | 42 @function |
43 @abstract Creates a JavaScript context group. | 43 @abstract Creates a JavaScript context group. |
44 @discussion A JSContextGroup associates JavaScript contexts with one another. | 44 @discussion A JSContextGroup associates JavaScript contexts with one another. |
45 Contexts in the same group may share and exchange JavaScript objects. Sharing a
nd/or exchanging | 45 Contexts in the same group may share and exchange JavaScript objects. Sharing a
nd/or exchanging |
46 JavaScript objects between contexts in different groups will produce undefined
behavior. | 46 JavaScript objects between contexts in different groups will produce undefined
behavior. |
47 When objects from the same context group are used in multiple threads, explicit | 47 When objects from the same context group are used in multiple threads, explicit |
48 synchronization is required. | 48 synchronization is required. |
49 @result The created JSContextGroup. | 49 @result The created JSContextGroup. |
50 */ | 50 */ |
51 JS_EXPORT JSContextGroupRef JSContextGroupCreate() AVAILABLE_AFTER_WEBKIT_VERSIO
N_3_1; | 51 JS_EXPORT JSContextGroupRef JSContextGroupCreate() AVAILABLE_IN_WEBKIT_VERSION_4
_0; |
52 | 52 |
53 /*! | 53 /*! |
54 @function | 54 @function |
55 @abstract Retains a JavaScript context group. | 55 @abstract Retains a JavaScript context group. |
56 @param group The JSContextGroup to retain. | 56 @param group The JSContextGroup to retain. |
57 @result A JSContextGroup that is the same as group. | 57 @result A JSContextGroup that is the same as group. |
58 */ | 58 */ |
59 JS_EXPORT JSContextGroupRef JSContextGroupRetain(JSContextGroupRef group) AVAILA
BLE_AFTER_WEBKIT_VERSION_3_1; | 59 JS_EXPORT JSContextGroupRef JSContextGroupRetain(JSContextGroupRef group) AVAILA
BLE_IN_WEBKIT_VERSION_4_0; |
60 | 60 |
61 /*! | 61 /*! |
62 @function | 62 @function |
63 @abstract Releases a JavaScript context group. | 63 @abstract Releases a JavaScript context group. |
64 @param group The JSContextGroup to release. | 64 @param group The JSContextGroup to release. |
65 */ | 65 */ |
66 JS_EXPORT void JSContextGroupRelease(JSContextGroupRef group) AVAILABLE_AFTER_WE
BKIT_VERSION_3_1; | 66 JS_EXPORT void JSContextGroupRelease(JSContextGroupRef group) AVAILABLE_IN_WEBKI
T_VERSION_4_0; |
67 | 67 |
68 /*! | 68 /*! |
69 @function | 69 @function |
70 @abstract Creates a global JavaScript execution context. | 70 @abstract Creates a global JavaScript execution context. |
71 @discussion JSGlobalContextCreate allocates a global object and populates it wit
h all the | 71 @discussion JSGlobalContextCreate allocates a global object and populates it wit
h all the |
72 built-in JavaScript objects, such as Object, Function, String, and Array. | 72 built-in JavaScript objects, such as Object, Function, String, and Array. |
73 | 73 |
74 In WebKit version 4.0 and later, the context is created in a unique context gro
up. | 74 In WebKit version 4.0 and later, the context is created in a unique context gro
up. |
75 Therefore, scripts may execute in it concurrently with scripts executing in oth
er contexts. | 75 Therefore, scripts may execute in it concurrently with scripts executing in oth
er contexts. |
76 However, you may not use values created in the context in other contexts. | 76 However, you may not use values created in the context in other contexts. |
77 @param globalObjectClass The class to use when creating the global object. Pass | 77 @param globalObjectClass The class to use when creating the global object. Pass |
78 NULL to use the default object class. | 78 NULL to use the default object class. |
79 @result A JSGlobalContext with a global object of class globalObjectClass. | 79 @result A JSGlobalContext with a global object of class globalObjectClass. |
80 */ | 80 */ |
81 JS_EXPORT JSGlobalContextRef JSGlobalContextCreate(JSClassRef globalObjectClass)
AVAILABLE_WEBKIT_VERSION_3_0_AND_LATER; | 81 JS_EXPORT JSGlobalContextRef JSGlobalContextCreate(JSClassRef globalObjectClass)
AVAILABLE_WEBKIT_VERSION_3_0_AND_LATER; |
82 | 82 |
83 /*! | 83 /*! |
84 @function | 84 @function |
85 @abstract Creates a global JavaScript execution context in the context group pro
vided. | 85 @abstract Creates a global JavaScript execution context in the context group pro
vided. |
86 @discussion JSGlobalContextCreateInGroup allocates a global object and populates
it with | 86 @discussion JSGlobalContextCreateInGroup allocates a global object and populates
it with |
87 all the built-in JavaScript objects, such as Object, Function, String, and Arra
y. | 87 all the built-in JavaScript objects, such as Object, Function, String, and Arra
y. |
88 @param globalObjectClass The class to use when creating the global object. Pass | 88 @param globalObjectClass The class to use when creating the global object. Pass |
89 NULL to use the default object class. | 89 NULL to use the default object class. |
90 @param group The context group to use. The created global context retains the gr
oup. | 90 @param group The context group to use. The created global context retains the gr
oup. |
91 Pass NULL to create a unique group for the context. | 91 Pass NULL to create a unique group for the context. |
92 @result A JSGlobalContext with a global object of class globalObjectClass and a
context | 92 @result A JSGlobalContext with a global object of class globalObjectClass and a
context |
93 group equal to group. | 93 group equal to group. |
94 */ | 94 */ |
95 JS_EXPORT JSGlobalContextRef JSGlobalContextCreateInGroup(JSContextGroupRef grou
p, JSClassRef globalObjectClass) AVAILABLE_AFTER_WEBKIT_VERSION_3_1; | 95 JS_EXPORT JSGlobalContextRef JSGlobalContextCreateInGroup(JSContextGroupRef grou
p, JSClassRef globalObjectClass) AVAILABLE_IN_WEBKIT_VERSION_4_0; |
96 | 96 |
97 /*! | 97 /*! |
98 @function | 98 @function |
99 @abstract Retains a global JavaScript execution context. | 99 @abstract Retains a global JavaScript execution context. |
100 @param ctx The JSGlobalContext to retain. | 100 @param ctx The JSGlobalContext to retain. |
101 @result A JSGlobalContext that is the same as ctx. | 101 @result A JSGlobalContext that is the same as ctx. |
102 */ | 102 */ |
103 JS_EXPORT JSGlobalContextRef JSGlobalContextRetain(JSGlobalContextRef ctx); | 103 JS_EXPORT JSGlobalContextRef JSGlobalContextRetain(JSGlobalContextRef ctx); |
104 | 104 |
105 /*! | 105 /*! |
(...skipping 10 matching lines...) Expand all Loading... |
116 @result ctx's global object. | 116 @result ctx's global object. |
117 */ | 117 */ |
118 JS_EXPORT JSObjectRef JSContextGetGlobalObject(JSContextRef ctx); | 118 JS_EXPORT JSObjectRef JSContextGetGlobalObject(JSContextRef ctx); |
119 | 119 |
120 /*! | 120 /*! |
121 @function | 121 @function |
122 @abstract Gets the context group to which a JavaScript execution context belongs
. | 122 @abstract Gets the context group to which a JavaScript execution context belongs
. |
123 @param ctx The JSContext whose group you want to get. | 123 @param ctx The JSContext whose group you want to get. |
124 @result ctx's group. | 124 @result ctx's group. |
125 */ | 125 */ |
126 JS_EXPORT JSContextGroupRef JSContextGetGroup(JSContextRef ctx) AVAILABLE_AFTER_
WEBKIT_VERSION_3_1; | 126 JS_EXPORT JSContextGroupRef JSContextGetGroup(JSContextRef ctx) AVAILABLE_IN_WEB
KIT_VERSION_4_0; |
127 | 127 |
128 #ifdef __cplusplus | 128 #ifdef __cplusplus |
129 } | 129 } |
130 #endif | 130 #endif |
131 | 131 |
132 #endif /* JSContextRef_h */ | 132 #endif /* JSContextRef_h */ |
OLD | NEW |