emnapi 0.36.3 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/library_napi.js +17 -8
  2. package/include/emnapi_common.h +2 -4
  3. package/include/js_native_api.h +402 -383
  4. package/include/js_native_api_types.h +14 -6
  5. package/include/node_api.h +145 -104
  6. package/include/node_api_types.h +8 -12
  7. package/package.json +1 -1
package/include/js_native_api.h CHANGED
@@ -2,8 +2,8 @@
2
2
  #define SRC_JS_NATIVE_API_H_
3
3
 
4
4
  // This file needs to be compatible with C compilers.
5
- #include <stddef.h> // NOLINT(modernize-deprecated-headers)
6
5
  #include <stdbool.h> // NOLINT(modernize-deprecated-headers)
6
+ #include <stddef.h> // NOLINT(modernize-deprecated-headers)
7
7
 
8
8
  // Use INT_MAX, this should only be consumed by the pre-processor anyway.
9
9
  #define NAPI_VERSION_EXPERIMENTAL 2147483647
@@ -22,240 +22,261 @@
22
22
  #endif
23
23
 
24
24
  #include "js_native_api_types.h"
25
+
26
+ #ifdef EMNAPI_UNMODIFIED_UPSTREAM
27
+ // If you need __declspec(dllimport), either include <node_api.h> instead, or
28
+ // define NAPI_EXTERN as __declspec(dllimport) on the compiler's command line.
29
+ #ifndef NAPI_EXTERN
30
+ #ifdef _WIN32
31
+ #define NAPI_EXTERN __declspec(dllexport)
32
+ #elif defined(__wasm32__)
33
+ #define NAPI_EXTERN \
34
+ __attribute__((visibility("default"))) \
35
+ __attribute__((__import_module__("napi")))
36
+ #else
37
+ #define NAPI_EXTERN __attribute__((visibility("default")))
38
+ #endif
39
+ #endif
40
+ #else
25
41
  #include "emnapi_common.h"
42
+ #endif
26
43
 
27
44
  #define NAPI_AUTO_LENGTH SIZE_MAX
28
45
 
46
+ #ifdef EMNAPI_UNMODIFIED_UPSTREAM
47
+ #ifdef __cplusplus
48
+ #define EXTERN_C_START extern "C" {
49
+ #define EXTERN_C_END }
50
+ #else
51
+ #define EXTERN_C_START
52
+ #define EXTERN_C_END
53
+ #endif
54
+ #endif
55
+
29
56
  EXTERN_C_START
30
57
 
31
- NAPI_EXTERN napi_status
32
- napi_get_last_error_info(napi_env env,
33
- const napi_extended_error_info** result);
58
+ NAPI_EXTERN napi_status NAPI_CDECL
59
+ napi_get_last_error_info(napi_env env, const napi_extended_error_info** result);
34
60
 
35
61
  // Getters for defined singletons
36
- NAPI_EXTERN napi_status napi_get_undefined(napi_env env, napi_value* result);
37
- NAPI_EXTERN napi_status napi_get_null(napi_env env, napi_value* result);
38
- NAPI_EXTERN napi_status napi_get_global(napi_env env, napi_value* result);
39
- NAPI_EXTERN napi_status napi_get_boolean(napi_env env,
40
- bool value,
41
- napi_value* result);
62
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_undefined(napi_env env,
63
+ napi_value* result);
64
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_null(napi_env env,
65
+ napi_value* result);
66
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_global(napi_env env,
67
+ napi_value* result);
68
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_boolean(napi_env env,
69
+ bool value,
70
+ napi_value* result);
42
71
 
43
72
  // Methods to create Primitive types/Objects
44
- NAPI_EXTERN napi_status napi_create_object(napi_env env, napi_value* result);
45
- NAPI_EXTERN napi_status napi_create_array(napi_env env, napi_value* result);
46
- NAPI_EXTERN napi_status napi_create_array_with_length(napi_env env,
47
- size_t length,
73
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_object(napi_env env,
74
+ napi_value* result);
75
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_array(napi_env env,
76
+ napi_value* result);
77
+ NAPI_EXTERN napi_status NAPI_CDECL
78
+ napi_create_array_with_length(napi_env env, size_t length, napi_value* result);
79
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_double(napi_env env,
80
+ double value,
81
+ napi_value* result);
82
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_int32(napi_env env,
83
+ int32_t value,
84
+ napi_value* result);
85
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_uint32(napi_env env,
86
+ uint32_t value,
87
+ napi_value* result);
88
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_int64(napi_env env,
89
+ int64_t value,
90
+ napi_value* result);
91
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_string_latin1(
92
+ napi_env env, const char* str, size_t length, napi_value* result);
93
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_string_utf8(napi_env env,
94
+ const char* str,
95
+ size_t length,
96
+ napi_value* result);
97
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_string_utf16(napi_env env,
98
+ const char16_t* str,
99
+ size_t length,
100
+ napi_value* result);
101
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_symbol(napi_env env,
102
+ napi_value description,
48
103
  napi_value* result);
49
- NAPI_EXTERN napi_status napi_create_double(napi_env env,
50
- double value,
51
- napi_value* result);
52
- NAPI_EXTERN napi_status napi_create_int32(napi_env env,
53
- int32_t value,
54
- napi_value* result);
55
- NAPI_EXTERN napi_status napi_create_uint32(napi_env env,
56
- uint32_t value,
57
- napi_value* result);
58
- NAPI_EXTERN napi_status napi_create_int64(napi_env env,
59
- int64_t value,
60
- napi_value* result);
61
- NAPI_EXTERN napi_status napi_create_string_latin1(napi_env env,
62
- const char* str,
63
- size_t length,
64
- napi_value* result);
65
- NAPI_EXTERN napi_status napi_create_string_utf8(napi_env env,
66
- const char* str,
67
- size_t length,
68
- napi_value* result);
69
- NAPI_EXTERN napi_status napi_create_string_utf16(napi_env env,
70
- const char16_t* str,
71
- size_t length,
72
- napi_value* result);
73
- NAPI_EXTERN napi_status napi_create_symbol(napi_env env,
74
- napi_value description,
75
- napi_value* result);
76
104
  #ifdef NAPI_EXPERIMENTAL
77
- NAPI_EXTERN napi_status node_api_symbol_for(napi_env env,
78
- const char* utf8description,
79
- size_t length,
80
- napi_value* result);
105
+ NAPI_EXTERN napi_status NAPI_CDECL
106
+ node_api_symbol_for(napi_env env,
107
+ const char* utf8description,
108
+ size_t length,
109
+ napi_value* result);
81
110
  #endif // NAPI_EXPERIMENTAL
82
- NAPI_EXTERN napi_status napi_create_function(napi_env env,
83
- const char* utf8name,
84
- size_t length,
85
- napi_callback cb,
86
- void* data,
87
- napi_value* result);
88
- NAPI_EXTERN napi_status napi_create_error(napi_env env,
89
- napi_value code,
90
- napi_value msg,
91
- napi_value* result);
92
- NAPI_EXTERN napi_status napi_create_type_error(napi_env env,
93
- napi_value code,
94
- napi_value msg,
95
- napi_value* result);
96
- NAPI_EXTERN napi_status napi_create_range_error(napi_env env,
97
- napi_value code,
98
- napi_value msg,
99
- napi_value* result);
100
- #ifdef NAPI_EXPERIMENTAL
101
- NAPI_EXTERN napi_status node_api_create_syntax_error(napi_env env,
111
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_function(napi_env env,
112
+ const char* utf8name,
113
+ size_t length,
114
+ napi_callback cb,
115
+ void* data,
116
+ napi_value* result);
117
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_error(napi_env env,
102
118
  napi_value code,
103
119
  napi_value msg,
104
120
  napi_value* result);
121
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_type_error(napi_env env,
122
+ napi_value code,
123
+ napi_value msg,
124
+ napi_value* result);
125
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_range_error(napi_env env,
126
+ napi_value code,
127
+ napi_value msg,
128
+ napi_value* result);
129
+ #ifdef NAPI_EXPERIMENTAL
130
+ NAPI_EXTERN napi_status NAPI_CDECL node_api_create_syntax_error(
131
+ napi_env env, napi_value code, napi_value msg, napi_value* result);
105
132
  #endif // NAPI_EXPERIMENTAL
106
133
 
107
134
  // Methods to get the native napi_value from Primitive type
108
- NAPI_EXTERN napi_status napi_typeof(napi_env env,
109
- napi_value value,
110
- napi_valuetype* result);
111
- NAPI_EXTERN napi_status napi_get_value_double(napi_env env,
112
- napi_value value,
113
- double* result);
114
- NAPI_EXTERN napi_status napi_get_value_int32(napi_env env,
115
- napi_value value,
116
- int32_t* result);
117
- NAPI_EXTERN napi_status napi_get_value_uint32(napi_env env,
118
- napi_value value,
119
- uint32_t* result);
120
- NAPI_EXTERN napi_status napi_get_value_int64(napi_env env,
121
- napi_value value,
122
- int64_t* result);
123
- NAPI_EXTERN napi_status napi_get_value_bool(napi_env env,
124
- napi_value value,
125
- bool* result);
135
+ NAPI_EXTERN napi_status NAPI_CDECL napi_typeof(napi_env env,
136
+ napi_value value,
137
+ napi_valuetype* result);
138
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_double(napi_env env,
139
+ napi_value value,
140
+ double* result);
141
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_int32(napi_env env,
142
+ napi_value value,
143
+ int32_t* result);
144
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_uint32(napi_env env,
145
+ napi_value value,
146
+ uint32_t* result);
147
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_int64(napi_env env,
148
+ napi_value value,
149
+ int64_t* result);
150
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_bool(napi_env env,
151
+ napi_value value,
152
+ bool* result);
126
153
 
127
154
  // Copies LATIN-1 encoded bytes from a string into a buffer.
128
- NAPI_EXTERN napi_status napi_get_value_string_latin1(napi_env env,
129
- napi_value value,
130
- char* buf,
131
- size_t bufsize,
132
- size_t* result);
155
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_string_latin1(
156
+ napi_env env, napi_value value, char* buf, size_t bufsize, size_t* result);
133
157
 
134
158
  // Copies UTF-8 encoded bytes from a string into a buffer.
135
- NAPI_EXTERN napi_status napi_get_value_string_utf8(napi_env env,
136
- napi_value value,
137
- char* buf,
138
- size_t bufsize,
139
- size_t* result);
159
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_string_utf8(
160
+ napi_env env, napi_value value, char* buf, size_t bufsize, size_t* result);
140
161
 
141
162
  // Copies UTF-16 encoded bytes from a string into a buffer.
142
- NAPI_EXTERN napi_status napi_get_value_string_utf16(napi_env env,
143
- napi_value value,
144
- char16_t* buf,
145
- size_t bufsize,
146
- size_t* result);
163
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_string_utf16(napi_env env,
164
+ napi_value value,
165
+ char16_t* buf,
166
+ size_t bufsize,
167
+ size_t* result);
147
168
 
148
169
  // Methods to coerce values
149
170
  // These APIs may execute user scripts
150
- NAPI_EXTERN napi_status napi_coerce_to_bool(napi_env env,
151
- napi_value value,
152
- napi_value* result);
153
- NAPI_EXTERN napi_status napi_coerce_to_number(napi_env env,
154
- napi_value value,
155
- napi_value* result);
156
- NAPI_EXTERN napi_status napi_coerce_to_object(napi_env env,
157
- napi_value value,
158
- napi_value* result);
159
- NAPI_EXTERN napi_status napi_coerce_to_string(napi_env env,
160
- napi_value value,
161
- napi_value* result);
171
+ NAPI_EXTERN napi_status NAPI_CDECL napi_coerce_to_bool(napi_env env,
172
+ napi_value value,
173
+ napi_value* result);
174
+ NAPI_EXTERN napi_status NAPI_CDECL napi_coerce_to_number(napi_env env,
175
+ napi_value value,
176
+ napi_value* result);
177
+ NAPI_EXTERN napi_status NAPI_CDECL napi_coerce_to_object(napi_env env,
178
+ napi_value value,
179
+ napi_value* result);
180
+ NAPI_EXTERN napi_status NAPI_CDECL napi_coerce_to_string(napi_env env,
181
+ napi_value value,
182
+ napi_value* result);
162
183
 
163
184
  // Methods to work with Objects
164
- NAPI_EXTERN napi_status napi_get_prototype(napi_env env,
165
- napi_value object,
166
- napi_value* result);
167
- NAPI_EXTERN napi_status napi_get_property_names(napi_env env,
168
- napi_value object,
169
- napi_value* result);
170
- NAPI_EXTERN napi_status napi_set_property(napi_env env,
171
- napi_value object,
172
- napi_value key,
173
- napi_value value);
174
- NAPI_EXTERN napi_status napi_has_property(napi_env env,
175
- napi_value object,
176
- napi_value key,
177
- bool* result);
178
- NAPI_EXTERN napi_status napi_get_property(napi_env env,
179
- napi_value object,
180
- napi_value key,
181
- napi_value* result);
182
- NAPI_EXTERN napi_status napi_delete_property(napi_env env,
183
- napi_value object,
184
- napi_value key,
185
- bool* result);
186
- NAPI_EXTERN napi_status napi_has_own_property(napi_env env,
187
- napi_value object,
188
- napi_value key,
189
- bool* result);
190
- NAPI_EXTERN napi_status napi_set_named_property(napi_env env,
191
- napi_value object,
192
- const char* utf8name,
193
- napi_value value);
194
- NAPI_EXTERN napi_status napi_has_named_property(napi_env env,
195
- napi_value object,
196
- const char* utf8name,
197
- bool* result);
198
- NAPI_EXTERN napi_status napi_get_named_property(napi_env env,
199
- napi_value object,
200
- const char* utf8name,
201
- napi_value* result);
202
- NAPI_EXTERN napi_status napi_set_element(napi_env env,
203
- napi_value object,
204
- uint32_t index,
205
- napi_value value);
206
- NAPI_EXTERN napi_status napi_has_element(napi_env env,
207
- napi_value object,
208
- uint32_t index,
209
- bool* result);
210
- NAPI_EXTERN napi_status napi_get_element(napi_env env,
211
- napi_value object,
212
- uint32_t index,
213
- napi_value* result);
214
- NAPI_EXTERN napi_status napi_delete_element(napi_env env,
215
- napi_value object,
216
- uint32_t index,
217
- bool* result);
218
- NAPI_EXTERN napi_status
185
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_prototype(napi_env env,
186
+ napi_value object,
187
+ napi_value* result);
188
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_property_names(napi_env env,
189
+ napi_value object,
190
+ napi_value* result);
191
+ NAPI_EXTERN napi_status NAPI_CDECL napi_set_property(napi_env env,
192
+ napi_value object,
193
+ napi_value key,
194
+ napi_value value);
195
+ NAPI_EXTERN napi_status NAPI_CDECL napi_has_property(napi_env env,
196
+ napi_value object,
197
+ napi_value key,
198
+ bool* result);
199
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_property(napi_env env,
200
+ napi_value object,
201
+ napi_value key,
202
+ napi_value* result);
203
+ NAPI_EXTERN napi_status NAPI_CDECL napi_delete_property(napi_env env,
204
+ napi_value object,
205
+ napi_value key,
206
+ bool* result);
207
+ NAPI_EXTERN napi_status NAPI_CDECL napi_has_own_property(napi_env env,
208
+ napi_value object,
209
+ napi_value key,
210
+ bool* result);
211
+ NAPI_EXTERN napi_status NAPI_CDECL napi_set_named_property(napi_env env,
212
+ napi_value object,
213
+ const char* utf8name,
214
+ napi_value value);
215
+ NAPI_EXTERN napi_status NAPI_CDECL napi_has_named_property(napi_env env,
216
+ napi_value object,
217
+ const char* utf8name,
218
+ bool* result);
219
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_named_property(napi_env env,
220
+ napi_value object,
221
+ const char* utf8name,
222
+ napi_value* result);
223
+ NAPI_EXTERN napi_status NAPI_CDECL napi_set_element(napi_env env,
224
+ napi_value object,
225
+ uint32_t index,
226
+ napi_value value);
227
+ NAPI_EXTERN napi_status NAPI_CDECL napi_has_element(napi_env env,
228
+ napi_value object,
229
+ uint32_t index,
230
+ bool* result);
231
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_element(napi_env env,
232
+ napi_value object,
233
+ uint32_t index,
234
+ napi_value* result);
235
+ NAPI_EXTERN napi_status NAPI_CDECL napi_delete_element(napi_env env,
236
+ napi_value object,
237
+ uint32_t index,
238
+ bool* result);
239
+ NAPI_EXTERN napi_status NAPI_CDECL
219
240
  napi_define_properties(napi_env env,
220
241
  napi_value object,
221
242
  size_t property_count,
222
243
  const napi_property_descriptor* properties);
223
244
 
224
245
  // Methods to work with Arrays
225
- NAPI_EXTERN napi_status napi_is_array(napi_env env,
226
- napi_value value,
227
- bool* result);
228
- NAPI_EXTERN napi_status napi_get_array_length(napi_env env,
229
- napi_value value,
230
- uint32_t* result);
246
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_array(napi_env env,
247
+ napi_value value,
248
+ bool* result);
249
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_array_length(napi_env env,
250
+ napi_value value,
251
+ uint32_t* result);
231
252
 
232
253
  // Methods to compare values
233
- NAPI_EXTERN napi_status napi_strict_equals(napi_env env,
234
- napi_value lhs,
235
- napi_value rhs,
236
- bool* result);
254
+ NAPI_EXTERN napi_status NAPI_CDECL napi_strict_equals(napi_env env,
255
+ napi_value lhs,
256
+ napi_value rhs,
257
+ bool* result);
237
258
 
238
259
  // Methods to work with Functions
239
- NAPI_EXTERN napi_status napi_call_function(napi_env env,
240
- napi_value recv,
241
- napi_value func,
242
- size_t argc,
243
- const napi_value* argv,
244
- napi_value* result);
245
- NAPI_EXTERN napi_status napi_new_instance(napi_env env,
246
- napi_value constructor,
247
- size_t argc,
248
- const napi_value* argv,
249
- napi_value* result);
250
- NAPI_EXTERN napi_status napi_instanceof(napi_env env,
251
- napi_value object,
252
- napi_value constructor,
253
- bool* result);
260
+ NAPI_EXTERN napi_status NAPI_CDECL napi_call_function(napi_env env,
261
+ napi_value recv,
262
+ napi_value func,
263
+ size_t argc,
264
+ const napi_value* argv,
265
+ napi_value* result);
266
+ NAPI_EXTERN napi_status NAPI_CDECL napi_new_instance(napi_env env,
267
+ napi_value constructor,
268
+ size_t argc,
269
+ const napi_value* argv,
270
+ napi_value* result);
271
+ NAPI_EXTERN napi_status NAPI_CDECL napi_instanceof(napi_env env,
272
+ napi_value object,
273
+ napi_value constructor,
274
+ bool* result);
254
275
 
255
276
  // Methods to work with napi_callbacks
256
277
 
257
278
  // Gets all callback info in a single call. (Ugly, but faster.)
258
- NAPI_EXTERN napi_status napi_get_cb_info(
279
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_cb_info(
259
280
  napi_env env, // [in] NAPI environment handle
260
281
  napi_callback_info cbinfo, // [in] Opaque callback-info handle
261
282
  size_t* argc, // [in-out] Specifies the size of the provided argv array
@@ -264,10 +285,9 @@ NAPI_EXTERN napi_status napi_get_cb_info(
264
285
  napi_value* this_arg, // [out] Receives the JS 'this' arg for the call
265
286
  void** data); // [out] Receives the data pointer for the callback.
266
287
 
267
- NAPI_EXTERN napi_status napi_get_new_target(napi_env env,
268
- napi_callback_info cbinfo,
269
- napi_value* result);
270
- NAPI_EXTERN napi_status
288
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_new_target(
289
+ napi_env env, napi_callback_info cbinfo, napi_value* result);
290
+ NAPI_EXTERN napi_status NAPI_CDECL
271
291
  napi_define_class(napi_env env,
272
292
  const char* utf8name,
273
293
  size_t length,
@@ -278,239 +298,242 @@ napi_define_class(napi_env env,
278
298
  napi_value* result);
279
299
 
280
300
  // Methods to work with external data objects
281
- NAPI_EXTERN napi_status napi_wrap(napi_env env,
282
- napi_value js_object,
283
- void* native_object,
284
- napi_finalize finalize_cb,
285
- void* finalize_hint,
286
- napi_ref* result);
287
- NAPI_EXTERN napi_status napi_unwrap(napi_env env,
288
- napi_value js_object,
289
- void** result);
290
- NAPI_EXTERN napi_status napi_remove_wrap(napi_env env,
291
- napi_value js_object,
292
- void** result);
293
- NAPI_EXTERN napi_status napi_create_external(napi_env env,
294
- void* data,
301
+ NAPI_EXTERN napi_status NAPI_CDECL napi_wrap(napi_env env,
302
+ napi_value js_object,
303
+ void* native_object,
295
304
  napi_finalize finalize_cb,
296
305
  void* finalize_hint,
297
- napi_value* result);
298
- NAPI_EXTERN napi_status napi_get_value_external(napi_env env,
299
- napi_value value,
300
- void** result);
306
+ napi_ref* result);
307
+ NAPI_EXTERN napi_status NAPI_CDECL napi_unwrap(napi_env env,
308
+ napi_value js_object,
309
+ void** result);
310
+ NAPI_EXTERN napi_status NAPI_CDECL napi_remove_wrap(napi_env env,
311
+ napi_value js_object,
312
+ void** result);
313
+ NAPI_EXTERN napi_status NAPI_CDECL
314
+ napi_create_external(napi_env env,
315
+ void* data,
316
+ napi_finalize finalize_cb,
317
+ void* finalize_hint,
318
+ napi_value* result);
319
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_external(napi_env env,
320
+ napi_value value,
321
+ void** result);
301
322
 
302
323
  // Methods to control object lifespan
303
324
 
304
325
  // Set initial_refcount to 0 for a weak reference, >0 for a strong reference.
305
- NAPI_EXTERN napi_status napi_create_reference(napi_env env,
306
- napi_value value,
307
- uint32_t initial_refcount,
308
- napi_ref* result);
326
+ NAPI_EXTERN napi_status NAPI_CDECL
327
+ napi_create_reference(napi_env env,
328
+ napi_value value,
329
+ uint32_t initial_refcount,
330
+ napi_ref* result);
309
331
 
310
332
  // Deletes a reference. The referenced value is released, and may
311
333
  // be GC'd unless there are other references to it.
312
- NAPI_EXTERN napi_status napi_delete_reference(napi_env env, napi_ref ref);
334
+ NAPI_EXTERN napi_status NAPI_CDECL napi_delete_reference(napi_env env,
335
+ napi_ref ref);
313
336
 
314
337
  // Increments the reference count, optionally returning the resulting count.
315
338
  // After this call the reference will be a strong reference because its
316
339
  // refcount is >0, and the referenced object is effectively "pinned".
317
340
  // Calling this when the refcount is 0 and the object is unavailable
318
341
  // results in an error.
319
- NAPI_EXTERN napi_status napi_reference_ref(napi_env env,
320
- napi_ref ref,
321
- uint32_t* result);
342
+ NAPI_EXTERN napi_status NAPI_CDECL napi_reference_ref(napi_env env,
343
+ napi_ref ref,
344
+ uint32_t* result);
322
345
 
323
346
  // Decrements the reference count, optionally returning the resulting count.
324
347
  // If the result is 0 the reference is now weak and the object may be GC'd
325
348
  // at any time if there are no other references. Calling this when the
326
349
  // refcount is already 0 results in an error.
327
- NAPI_EXTERN napi_status napi_reference_unref(napi_env env,
328
- napi_ref ref,
329
- uint32_t* result);
350
+ NAPI_EXTERN napi_status NAPI_CDECL napi_reference_unref(napi_env env,
351
+ napi_ref ref,
352
+ uint32_t* result);
330
353
 
331
354
  // Attempts to get a referenced value. If the reference is weak,
332
355
  // the value might no longer be available, in that case the call
333
356
  // is still successful but the result is NULL.
334
- NAPI_EXTERN napi_status napi_get_reference_value(napi_env env,
335
- napi_ref ref,
336
- napi_value* result);
337
-
338
- NAPI_EXTERN napi_status napi_open_handle_scope(napi_env env,
339
- napi_handle_scope* result);
340
- NAPI_EXTERN napi_status napi_close_handle_scope(napi_env env,
341
- napi_handle_scope scope);
342
- NAPI_EXTERN napi_status
343
- napi_open_escapable_handle_scope(napi_env env,
344
- napi_escapable_handle_scope* result);
345
- NAPI_EXTERN napi_status
346
- napi_close_escapable_handle_scope(napi_env env,
347
- napi_escapable_handle_scope scope);
348
-
349
- NAPI_EXTERN napi_status napi_escape_handle(napi_env env,
350
- napi_escapable_handle_scope scope,
351
- napi_value escapee,
352
- napi_value* result);
357
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_reference_value(napi_env env,
358
+ napi_ref ref,
359
+ napi_value* result);
360
+
361
+ NAPI_EXTERN napi_status NAPI_CDECL
362
+ napi_open_handle_scope(napi_env env, napi_handle_scope* result);
363
+ NAPI_EXTERN napi_status NAPI_CDECL
364
+ napi_close_handle_scope(napi_env env, napi_handle_scope scope);
365
+ NAPI_EXTERN napi_status NAPI_CDECL napi_open_escapable_handle_scope(
366
+ napi_env env, napi_escapable_handle_scope* result);
367
+ NAPI_EXTERN napi_status NAPI_CDECL napi_close_escapable_handle_scope(
368
+ napi_env env, napi_escapable_handle_scope scope);
369
+
370
+ NAPI_EXTERN napi_status NAPI_CDECL
371
+ napi_escape_handle(napi_env env,
372
+ napi_escapable_handle_scope scope,
373
+ napi_value escapee,
374
+ napi_value* result);
353
375
 
354
376
  // Methods to support error handling
355
- NAPI_EXTERN napi_status napi_throw(napi_env env, napi_value error);
356
- NAPI_EXTERN napi_status napi_throw_error(napi_env env,
357
- const char* code,
358
- const char* msg);
359
- NAPI_EXTERN napi_status napi_throw_type_error(napi_env env,
360
- const char* code,
361
- const char* msg);
362
- NAPI_EXTERN napi_status napi_throw_range_error(napi_env env,
363
- const char* code,
364
- const char* msg);
365
- #ifdef NAPI_EXPERIMENTAL
366
- NAPI_EXTERN napi_status node_api_throw_syntax_error(napi_env env,
377
+ NAPI_EXTERN napi_status NAPI_CDECL napi_throw(napi_env env, napi_value error);
378
+ NAPI_EXTERN napi_status NAPI_CDECL napi_throw_error(napi_env env,
367
379
  const char* code,
368
380
  const char* msg);
381
+ NAPI_EXTERN napi_status NAPI_CDECL napi_throw_type_error(napi_env env,
382
+ const char* code,
383
+ const char* msg);
384
+ NAPI_EXTERN napi_status NAPI_CDECL napi_throw_range_error(napi_env env,
385
+ const char* code,
386
+ const char* msg);
387
+ #ifdef NAPI_EXPERIMENTAL
388
+ NAPI_EXTERN napi_status NAPI_CDECL node_api_throw_syntax_error(napi_env env,
389
+ const char* code,
390
+ const char* msg);
369
391
  #endif // NAPI_EXPERIMENTAL
370
- NAPI_EXTERN napi_status napi_is_error(napi_env env,
371
- napi_value value,
372
- bool* result);
392
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_error(napi_env env,
393
+ napi_value value,
394
+ bool* result);
373
395
 
374
396
  // Methods to support catching exceptions
375
- NAPI_EXTERN napi_status napi_is_exception_pending(napi_env env, bool* result);
376
- NAPI_EXTERN napi_status napi_get_and_clear_last_exception(napi_env env,
377
- napi_value* result);
397
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_exception_pending(napi_env env,
398
+ bool* result);
399
+ NAPI_EXTERN napi_status NAPI_CDECL
400
+ napi_get_and_clear_last_exception(napi_env env, napi_value* result);
378
401
 
379
402
  // Methods to work with array buffers and typed arrays
380
- NAPI_EXTERN napi_status napi_is_arraybuffer(napi_env env,
381
- napi_value value,
382
- bool* result);
383
- NAPI_EXTERN napi_status napi_create_arraybuffer(napi_env env,
384
- size_t byte_length,
385
- void** data,
386
- napi_value* result);
403
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_arraybuffer(napi_env env,
404
+ napi_value value,
405
+ bool* result);
406
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_arraybuffer(napi_env env,
407
+ size_t byte_length,
408
+ void** data,
409
+ napi_value* result);
387
410
  #ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED
388
- NAPI_EXTERN napi_status
411
+ NAPI_EXTERN napi_status NAPI_CDECL
389
412
  napi_create_external_arraybuffer(napi_env env,
390
413
  void* external_data,
391
414
  size_t byte_length,
392
415
  napi_finalize finalize_cb,
393
416
  void* finalize_hint,
394
417
  napi_value* result);
395
- #endif
396
- NAPI_EXTERN napi_status napi_get_arraybuffer_info(napi_env env,
397
- napi_value arraybuffer,
398
- void** data,
399
- size_t* byte_length);
400
- NAPI_EXTERN napi_status napi_is_typedarray(napi_env env,
401
- napi_value value,
402
- bool* result);
403
- NAPI_EXTERN napi_status napi_create_typedarray(napi_env env,
404
- napi_typedarray_type type,
405
- size_t length,
406
- napi_value arraybuffer,
407
- size_t byte_offset,
408
- napi_value* result);
409
- NAPI_EXTERN napi_status napi_get_typedarray_info(napi_env env,
410
- napi_value typedarray,
411
- napi_typedarray_type* type,
412
- size_t* length,
413
- void** data,
414
- napi_value* arraybuffer,
415
- size_t* byte_offset);
416
-
417
- NAPI_EXTERN napi_status napi_create_dataview(napi_env env,
418
- size_t length,
419
- napi_value arraybuffer,
420
- size_t byte_offset,
421
- napi_value* result);
422
- NAPI_EXTERN napi_status napi_is_dataview(napi_env env,
423
- napi_value value,
424
- bool* result);
425
- NAPI_EXTERN napi_status napi_get_dataview_info(napi_env env,
426
- napi_value dataview,
427
- size_t* bytelength,
428
- void** data,
429
- napi_value* arraybuffer,
430
- size_t* byte_offset);
418
+ #endif // NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED
419
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_arraybuffer_info(
420
+ napi_env env, napi_value arraybuffer, void** data, size_t* byte_length);
421
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_typedarray(napi_env env,
422
+ napi_value value,
423
+ bool* result);
424
+ NAPI_EXTERN napi_status NAPI_CDECL
425
+ napi_create_typedarray(napi_env env,
426
+ napi_typedarray_type type,
427
+ size_t length,
428
+ napi_value arraybuffer,
429
+ size_t byte_offset,
430
+ napi_value* result);
431
+ NAPI_EXTERN napi_status NAPI_CDECL
432
+ napi_get_typedarray_info(napi_env env,
433
+ napi_value typedarray,
434
+ napi_typedarray_type* type,
435
+ size_t* length,
436
+ void** data,
437
+ napi_value* arraybuffer,
438
+ size_t* byte_offset);
439
+
440
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_dataview(napi_env env,
441
+ size_t length,
442
+ napi_value arraybuffer,
443
+ size_t byte_offset,
444
+ napi_value* result);
445
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_dataview(napi_env env,
446
+ napi_value value,
447
+ bool* result);
448
+ NAPI_EXTERN napi_status NAPI_CDECL
449
+ napi_get_dataview_info(napi_env env,
450
+ napi_value dataview,
451
+ size_t* bytelength,
452
+ void** data,
453
+ napi_value* arraybuffer,
454
+ size_t* byte_offset);
431
455
 
432
456
  // version management
433
- NAPI_EXTERN napi_status napi_get_version(napi_env env, uint32_t* result);
457
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_version(napi_env env,
458
+ uint32_t* result);
434
459
 
435
460
  // Promises
436
- NAPI_EXTERN napi_status napi_create_promise(napi_env env,
437
- napi_deferred* deferred,
438
- napi_value* promise);
439
- NAPI_EXTERN napi_status napi_resolve_deferred(napi_env env,
440
- napi_deferred deferred,
441
- napi_value resolution);
442
- NAPI_EXTERN napi_status napi_reject_deferred(napi_env env,
443
- napi_deferred deferred,
444
- napi_value rejection);
445
- NAPI_EXTERN napi_status napi_is_promise(napi_env env,
446
- napi_value value,
447
- bool* is_promise);
461
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_promise(napi_env env,
462
+ napi_deferred* deferred,
463
+ napi_value* promise);
464
+ NAPI_EXTERN napi_status NAPI_CDECL napi_resolve_deferred(napi_env env,
465
+ napi_deferred deferred,
466
+ napi_value resolution);
467
+ NAPI_EXTERN napi_status NAPI_CDECL napi_reject_deferred(napi_env env,
468
+ napi_deferred deferred,
469
+ napi_value rejection);
470
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_promise(napi_env env,
471
+ napi_value value,
472
+ bool* is_promise);
448
473
 
449
474
  // Running a script
450
- NAPI_EXTERN napi_status napi_run_script(napi_env env,
451
- napi_value script,
452
- napi_value* result);
475
+ NAPI_EXTERN napi_status NAPI_CDECL napi_run_script(napi_env env,
476
+ napi_value script,
477
+ napi_value* result);
453
478
 
454
479
  // Memory management
455
- NAPI_EXTERN napi_status napi_adjust_external_memory(napi_env env,
456
- int64_t change_in_bytes,
457
- int64_t* adjusted_value);
480
+ NAPI_EXTERN napi_status NAPI_CDECL napi_adjust_external_memory(
481
+ napi_env env, int64_t change_in_bytes, int64_t* adjusted_value);
458
482
 
459
483
  #if NAPI_VERSION >= 5
460
484
 
461
485
  // Dates
462
- NAPI_EXTERN napi_status napi_create_date(napi_env env,
463
- double time,
464
- napi_value* result);
486
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_date(napi_env env,
487
+ double time,
488
+ napi_value* result);
465
489
 
466
- NAPI_EXTERN napi_status napi_is_date(napi_env env,
467
- napi_value value,
468
- bool* is_date);
490
+ NAPI_EXTERN napi_status NAPI_CDECL napi_is_date(napi_env env,
491
+ napi_value value,
492
+ bool* is_date);
469
493
 
470
- NAPI_EXTERN napi_status napi_get_date_value(napi_env env,
471
- napi_value value,
472
- double* result);
494
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_date_value(napi_env env,
495
+ napi_value value,
496
+ double* result);
473
497
 
474
498
  // Add finalizer for pointer
475
- NAPI_EXTERN napi_status napi_add_finalizer(napi_env env,
476
- napi_value js_object,
477
- void* finalize_data,
478
- napi_finalize finalize_cb,
479
- void* finalize_hint,
480
- napi_ref* result);
499
+ NAPI_EXTERN napi_status NAPI_CDECL napi_add_finalizer(napi_env env,
500
+ napi_value js_object,
501
+ void* finalize_data,
502
+ napi_finalize finalize_cb,
503
+ void* finalize_hint,
504
+ napi_ref* result);
481
505
 
482
506
  #endif // NAPI_VERSION >= 5
483
507
 
484
508
  #if NAPI_VERSION >= 6
485
509
 
486
510
  // BigInt
487
- NAPI_EXTERN napi_status napi_create_bigint_int64(napi_env env,
488
- int64_t value,
489
- napi_value* result);
490
- NAPI_EXTERN napi_status napi_create_bigint_uint64(napi_env env,
491
- uint64_t value,
492
- napi_value* result);
493
- NAPI_EXTERN napi_status napi_create_bigint_words(napi_env env,
494
- int sign_bit,
495
- size_t word_count,
496
- const uint64_t* words,
497
- napi_value* result);
498
- NAPI_EXTERN napi_status napi_get_value_bigint_int64(napi_env env,
499
- napi_value value,
500
- int64_t* result,
501
- bool* lossless);
502
- NAPI_EXTERN napi_status napi_get_value_bigint_uint64(napi_env env,
503
- napi_value value,
504
- uint64_t* result,
505
- bool* lossless);
506
- NAPI_EXTERN napi_status napi_get_value_bigint_words(napi_env env,
507
- napi_value value,
508
- int* sign_bit,
509
- size_t* word_count,
510
- uint64_t* words);
511
+ NAPI_EXTERN napi_status NAPI_CDECL napi_create_bigint_int64(napi_env env,
512
+ int64_t value,
513
+ napi_value* result);
514
+ NAPI_EXTERN napi_status NAPI_CDECL
515
+ napi_create_bigint_uint64(napi_env env, uint64_t value, napi_value* result);
516
+ NAPI_EXTERN napi_status NAPI_CDECL
517
+ napi_create_bigint_words(napi_env env,
518
+ int sign_bit,
519
+ size_t word_count,
520
+ const uint64_t* words,
521
+ napi_value* result);
522
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_bigint_int64(napi_env env,
523
+ napi_value value,
524
+ int64_t* result,
525
+ bool* lossless);
526
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_value_bigint_uint64(
527
+ napi_env env, napi_value value, uint64_t* result, bool* lossless);
528
+ NAPI_EXTERN napi_status NAPI_CDECL
529
+ napi_get_value_bigint_words(napi_env env,
530
+ napi_value value,
531
+ int* sign_bit,
532
+ size_t* word_count,
533
+ uint64_t* words);
511
534
 
512
535
  // Object
513
- NAPI_EXTERN napi_status
536
+ NAPI_EXTERN napi_status NAPI_CDECL
514
537
  napi_get_all_property_names(napi_env env,
515
538
  napi_value object,
516
539
  napi_key_collection_mode key_mode,
@@ -519,40 +542,36 @@ napi_get_all_property_names(napi_env env,
519
542
  napi_value* result);
520
543
 
521
544
  // Instance data
522
- NAPI_EXTERN napi_status napi_set_instance_data(napi_env env,
523
- void* data,
524
- napi_finalize finalize_cb,
525
- void* finalize_hint);
545
+ NAPI_EXTERN napi_status NAPI_CDECL napi_set_instance_data(
546
+ napi_env env, void* data, napi_finalize finalize_cb, void* finalize_hint);
526
547
 
527
- NAPI_EXTERN napi_status napi_get_instance_data(napi_env env,
528
- void** data);
548
+ NAPI_EXTERN napi_status NAPI_CDECL napi_get_instance_data(napi_env env,
549
+ void** data);
529
550
  #endif // NAPI_VERSION >= 6
530
551
 
531
552
  #if NAPI_VERSION >= 7
532
553
  // ArrayBuffer detaching
533
- NAPI_EXTERN napi_status napi_detach_arraybuffer(napi_env env,
534
- napi_value arraybuffer);
554
+ NAPI_EXTERN napi_status NAPI_CDECL
555
+ napi_detach_arraybuffer(napi_env env, napi_value arraybuffer);
535
556
 
536
- NAPI_EXTERN napi_status napi_is_detached_arraybuffer(napi_env env,
537
- napi_value value,
538
- bool* result);
557
+ NAPI_EXTERN napi_status NAPI_CDECL
558
+ napi_is_detached_arraybuffer(napi_env env, napi_value value, bool* result);
539
559
  #endif // NAPI_VERSION >= 7
540
560
 
541
561
  #if NAPI_VERSION >= 8
542
562
  // Type tagging
543
- NAPI_EXTERN napi_status napi_type_tag_object(napi_env env,
544
- napi_value value,
545
- const napi_type_tag* type_tag);
563
+ NAPI_EXTERN napi_status NAPI_CDECL napi_type_tag_object(
564
+ napi_env env, napi_value value, const napi_type_tag* type_tag);
546
565
 
547
- NAPI_EXTERN napi_status
566
+ NAPI_EXTERN napi_status NAPI_CDECL
548
567
  napi_check_object_type_tag(napi_env env,
549
568
  napi_value value,
550
569
  const napi_type_tag* type_tag,
551
570
  bool* result);
552
- NAPI_EXTERN napi_status napi_object_freeze(napi_env env,
553
- napi_value object);
554
- NAPI_EXTERN napi_status napi_object_seal(napi_env env,
555
- napi_value object);
571
+ NAPI_EXTERN napi_status NAPI_CDECL napi_object_freeze(napi_env env,
572
+ napi_value object);
573
+ NAPI_EXTERN napi_status NAPI_CDECL napi_object_seal(napi_env env,
574
+ napi_value object);
556
575
  #endif // NAPI_VERSION >= 8
557
576
 
558
577
  EXTERN_C_END