1 /**********************************************************************************
2 * NAN - Native Abstractions for Node.js
4 * Copyright (c) 2014 NAN contributors:
5 * - Rod Vagg <https://github.com/rvagg>
6 * - Benjamin Byholm <https://github.com/kkoopa>
7 * - Trevor Norris <https://github.com/trevnorris>
8 * - Nathan Rajlich <https://github.com/TooTallNate>
9 * - Brett Lawson <https://github.com/brett19>
10 * - Ben Noordhuis <https://github.com/bnoordhuis>
12 * MIT +no-false-attribs License <https://github.com/rvagg/nan/blob/master/LICENSE>
14 * Version 1.0.0 (current Node unstable: 0.11.13, Node stable: 0.10.28)
18 * - Heavy API changes for V8 3.25 / Node 0.11.13
20 * - Removed NanInitPersistent
21 * - Removed NanPersistentToLocal
22 * - Removed NanFromV8String
23 * - Removed NanMakeWeak
24 * - Removed NanNewLocal
25 * - Removed NAN_WEAK_CALLBACK_OBJECT
26 * - Removed NAN_WEAK_CALLBACK_DATA
27 * - Introduce NanNew, replaces NanNewLocal, NanPersistentToLocal, adds many overloaded typed versions
28 * - Introduce NanUndefined, NanNull, NanTrue and NanFalse
29 * - Introduce NanEscapableScope and NanEscapeScope
30 * - Introduce NanMakeWeakPersistent (requires a special callback to work on both old and new node)
31 * - Introduce NanMakeCallback for node::MakeCallback
32 * - Introduce NanSetTemplate
33 * - Introduce NanGetCurrentContext
34 * - Introduce NanCompileScript and NanRunScript
35 * - Introduce NanAdjustExternalMemory
36 * - Introduce NanAddGCEpilogueCallback, NanAddGCPrologueCallback, NanRemoveGCEpilogueCallback, NanRemoveGCPrologueCallback
37 * - Introduce NanGetHeapStatistics
38 * - Rename NanAsyncWorker#SavePersistent() to SaveToPersistent()
41 * - NanDispose -> NanDisposePersistent, deprecate NanDispose
42 * - Extract _NAN_*_RETURN_TYPE, pull up NAN_*()
45 * - Fixes to work against debug builds of Node
46 * - Safer NanPersistentToLocal (avoid reinterpret_cast)
47 * - Speed up common NanRawString case by only extracting flattened string when necessary
50 * - New no-arg form of NanCallback() constructor.
51 * - NanCallback#Call takes Handle rather than Local
52 * - Removed deprecated NanCallback#Run method, use NanCallback#Call instead
53 * - Split off _NAN_*_ARGS_TYPE from _NAN_*_ARGS
54 * - Restore (unofficial) Node 0.6 compatibility at NanCallback#Call()
55 * - Introduce NanRawString() for char* (or appropriate void*) from v8::String
56 * (replacement for NanFromV8String)
57 * - Introduce NanCString() for null-terminated char* from v8::String
60 * - Introduce NanNewLocal<T>(v8::Handle<T> value) for use in place of
61 * v8::Local<T>::New(...) since v8 started requiring isolate in Node 0.11.9
64 * - Convert SavePersistent and GetFromPersistent in NanAsyncWorker from protected and public
67 * - Use node::MakeCallback() instead of direct v8::Function::Call()
70 * - Added @TooTallNate as collaborator
71 * - New, much simpler, "include_dirs" for binding.gyp
72 * - Added full range of NAN_INDEX_* macros to match NAN_PROPERTY_* macros
75 * - Isolate argument from v8::Persistent::MakeWeak removed for 0.11.8+
78 * - Include node_object_wrap.h, removed from node.h for Node 0.11.8.
81 * - Handle deprecation of v8::Persistent::Dispose(v8::Isolate* isolate)) for
82 * Node 0.11.8 release.
85 * - Added explicit `#include <uv.h>` as it was removed from node.h for v0.11.8
88 * - Added NAN_INLINE and NAN_DEPRECATED and made use of them
89 * - Added NanError, NanTypeError and NanRangeError
93 * - Fix missing scope declaration in GetFromPersistent() and SaveToPersistent
97 * - fix "not all control paths return a value" compile warning on some platforms
100 * - Made NAN work with NPM
101 * - Lots of fixes to NanFromV8String, pulling in features from new Node core
102 * - Changed node::encoding to Nan::Encoding in NanFromV8String to unify the API
103 * - Added optional error number argument for NanThrowError()
104 * - Added NanInitPersistent()
105 * - Added NanReturnNull() and NanReturnEmptyString()
106 * - Added NanLocker and NanUnlocker
107 * - Added missing scopes
108 * - Made sure to clear disposed Persistent handles
109 * - Changed NanAsyncWorker to allocate error messages on the heap
110 * - Changed NanThrowError(Local<Value>) to NanThrowError(Handle<Value>)
111 * - Fixed leak in NanAsyncWorker when errmsg is used
114 * - Fixed usage of undefined variable with node::BASE64 in NanFromV8String()
117 * - Fixed 0.8 breakage, node::BUFFER encoding type not available in 0.8 for
121 * - Added NAN_PROPERTY_GETTER, NAN_PROPERTY_SETTER, NAN_PROPERTY_ENUMERATOR,
122 * NAN_PROPERTY_DELETER, NAN_PROPERTY_QUERY
123 * - Extracted _NAN_METHOD_ARGS, _NAN_GETTER_ARGS, _NAN_SETTER_ARGS,
124 * _NAN_PROPERTY_GETTER_ARGS, _NAN_PROPERTY_SETTER_ARGS,
125 * _NAN_PROPERTY_ENUMERATOR_ARGS, _NAN_PROPERTY_DELETER_ARGS,
126 * _NAN_PROPERTY_QUERY_ARGS
127 * - Added NanGetInternalFieldPointer, NanSetInternalFieldPointer
128 * - Added NAN_WEAK_CALLBACK, NAN_WEAK_CALLBACK_OBJECT,
129 * NAN_WEAK_CALLBACK_DATA, NanMakeWeak
130 * - Renamed THROW_ERROR to _NAN_THROW_ERROR
131 * - Added NanNewBufferHandle(char*, size_t, node::smalloc::FreeCallback, void*)
132 * - Added NanBufferUse(char*, uint32_t)
133 * - Added NanNewContextHandle(v8::ExtensionConfiguration*,
134 * v8::Handle<v8::ObjectTemplate>, v8::Handle<v8::Value>)
135 * - Fixed broken NanCallback#GetFunction()
136 * - Added optional encoding and size arguments to NanFromV8String()
137 * - Added NanGetPointerSafe() and NanSetPointerSafe()
138 * - Added initial test suite (to be expanded)
139 * - Allow NanUInt32OptionValue to convert any Number object
141 * * 0.1.0 Jul 21 2013
142 * - Added `NAN_GETTER`, `NAN_SETTER`
143 * - Added `NanThrowError` with single Local<Value> argument
144 * - Added `NanNewBufferHandle` with single uint32_t argument
145 * - Added `NanHasInstance(Persistent<FunctionTemplate>&, Handle<Value>)`
146 * - Added `Local<Function> NanCallback#GetFunction()`
147 * - Added `NanCallback#Call(int, Local<Value>[])`
148 * - Deprecated `NanCallback#Run(int, Local<Value>[])` in favour of Call
150 * See https://github.com/rvagg/nan for the latest update to this file
151 **********************************************************************************/
158 #include <node_buffer.h>
159 #include <node_version.h>
160 #include <node_object_wrap.h>
163 #if defined(__GNUC__) && !defined(DEBUG)
164 # define NAN_INLINE inline __attribute__((always_inline))
165 #elif defined(_MSC_VER) && !defined(DEBUG)
166 # define NAN_INLINE __forceinline
168 # define NAN_INLINE inline
171 #if defined(__GNUC__) && !V8_DISABLE_DEPRECATIONS
172 # define NAN_DEPRECATED __attribute__((deprecated))
173 #elif defined(_MSC_VER) && !V8_DISABLE_DEPRECATIONS
174 # define NAN_DEPRECATED __declspec(deprecated)
176 # define NAN_DEPRECATED
179 // some generic helpers
181 template<typename T> NAN_INLINE bool NanSetPointerSafe(
193 template<typename T> NAN_INLINE T NanGetPointerSafe(
195 , T fallback = reinterpret_cast<T>(0)
204 NAN_INLINE bool NanBooleanOptionValue(
205 v8::Local<v8::Object> optionsObj
206 , v8::Handle<v8::String> opt, bool def
209 return optionsObj.IsEmpty()
210 || !optionsObj->Has(opt)
211 || optionsObj->Get(opt)->BooleanValue();
213 return !optionsObj.IsEmpty()
214 && optionsObj->Has(opt)
215 && optionsObj->Get(opt)->BooleanValue();
219 NAN_INLINE bool NanBooleanOptionValue(
220 v8::Local<v8::Object> optionsObj
221 , v8::Handle<v8::String> opt
223 return NanBooleanOptionValue(optionsObj, opt, false);
226 NAN_INLINE uint32_t NanUInt32OptionValue(
227 v8::Local<v8::Object> optionsObj
228 , v8::Handle<v8::String> opt
231 return !optionsObj.IsEmpty()
232 && optionsObj->Has(opt)
233 && optionsObj->Get(opt)->IsNumber()
234 ? optionsObj->Get(opt)->Uint32Value()
238 #if (NODE_MODULE_VERSION > 0x000B)
239 // Node 0.11+ (0.11.3 and below won't compile with these)
241 # define _NAN_METHOD_ARGS_TYPE const v8::FunctionCallbackInfo<v8::Value>&
242 # define _NAN_METHOD_ARGS _NAN_METHOD_ARGS_TYPE args
243 # define _NAN_METHOD_RETURN_TYPE void
245 # define _NAN_GETTER_ARGS_TYPE const v8::PropertyCallbackInfo<v8::Value>&
246 # define _NAN_GETTER_ARGS _NAN_GETTER_ARGS_TYPE args
247 # define _NAN_GETTER_RETURN_TYPE void
249 # define _NAN_SETTER_ARGS_TYPE const v8::PropertyCallbackInfo<void>&
250 # define _NAN_SETTER_ARGS _NAN_SETTER_ARGS_TYPE args
251 # define _NAN_SETTER_RETURN_TYPE void
253 # define _NAN_PROPERTY_GETTER_ARGS_TYPE \
254 const v8::PropertyCallbackInfo<v8::Value>&
255 # define _NAN_PROPERTY_GETTER_ARGS _NAN_PROPERTY_GETTER_ARGS_TYPE args
256 # define _NAN_PROPERTY_GETTER_RETURN_TYPE void
258 # define _NAN_PROPERTY_SETTER_ARGS_TYPE \
259 const v8::PropertyCallbackInfo<v8::Value>&
260 # define _NAN_PROPERTY_SETTER_ARGS _NAN_PROPERTY_SETTER_ARGS_TYPE args
261 # define _NAN_PROPERTY_SETTER_RETURN_TYPE void
263 # define _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE \
264 const v8::PropertyCallbackInfo<v8::Array>&
265 # define _NAN_PROPERTY_ENUMERATOR_ARGS _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE args
266 # define _NAN_PROPERTY_ENUMERATOR_RETURN_TYPE void
268 # define _NAN_PROPERTY_DELETER_ARGS_TYPE \
269 const v8::PropertyCallbackInfo<v8::Boolean>&
270 # define _NAN_PROPERTY_DELETER_ARGS \
271 _NAN_PROPERTY_DELETER_ARGS_TYPE args
272 # define _NAN_PROPERTY_DELETER_RETURN_TYPE void
274 # define _NAN_PROPERTY_QUERY_ARGS_TYPE \
275 const v8::PropertyCallbackInfo<v8::Integer>&
276 # define _NAN_PROPERTY_QUERY_ARGS _NAN_PROPERTY_QUERY_ARGS_TYPE args
277 # define _NAN_PROPERTY_QUERY_RETURN_TYPE void
279 # define _NAN_INDEX_GETTER_ARGS_TYPE \
280 const v8::PropertyCallbackInfo<v8::Value>&
281 # define _NAN_INDEX_GETTER_ARGS _NAN_INDEX_GETTER_ARGS_TYPE args
282 # define _NAN_INDEX_GETTER_RETURN_TYPE void
284 # define _NAN_INDEX_SETTER_ARGS_TYPE \
285 const v8::PropertyCallbackInfo<v8::Value>&
286 # define _NAN_INDEX_SETTER_ARGS _NAN_INDEX_SETTER_ARGS_TYPE args
287 # define _NAN_INDEX_SETTER_RETURN_TYPE void
289 # define _NAN_INDEX_ENUMERATOR_ARGS_TYPE \
290 const v8::PropertyCallbackInfo<v8::Array>&
291 # define _NAN_INDEX_ENUMERATOR_ARGS _NAN_INDEX_ENUMERATOR_ARGS_TYPE args
292 # define _NAN_INDEX_ENUMERATOR_RETURN_TYPE void
294 # define _NAN_INDEX_DELETER_ARGS_TYPE \
295 const v8::PropertyCallbackInfo<v8::Boolean>&
296 # define _NAN_INDEX_DELETER_ARGS _NAN_INDEX_DELETER_ARGS_TYPE args
297 # define _NAN_INDEX_DELETER_RETURN_TYPE void
299 # define _NAN_INDEX_QUERY_ARGS_TYPE \
300 const v8::PropertyCallbackInfo<v8::Integer>&
301 # define _NAN_INDEX_QUERY_ARGS _NAN_INDEX_QUERY_ARGS_TYPE args
302 # define _NAN_INDEX_QUERY_RETURN_TYPE void
304 typedef v8::FunctionCallback NanFunctionCallback;
305 static v8::Isolate* nan_isolate = v8::Isolate::GetCurrent();
307 # define NanUndefined() v8::Undefined(nan_isolate)
308 # define NanNull() v8::Null(nan_isolate)
309 # define NanTrue() v8::True(nan_isolate)
310 # define NanFalse() v8::False(nan_isolate)
311 # define NanAdjustExternalMemory(amount) \
312 nan_isolate->AdjustAmountOfExternalAllocatedMemory(amount)
313 # define NanSetTemplate(templ, name, value) templ->Set(nan_isolate, name, value)
314 # define NanGetCurrentContext() nan_isolate->GetCurrentContext()
315 # define NanMakeCallback(target, func, argc, argv) \
316 node::MakeCallback(nan_isolate, target, func, argc, argv)
317 # define NanGetInternalFieldPointer(object, index) \
318 object->GetAlignedPointerFromInternalField(index)
319 # define NanSetInternalFieldPointer(object, index, value) \
320 object->SetAlignedPointerInInternalField(index, value)
323 NAN_INLINE v8::Local<T> NanNew() {
324 return T::New(nan_isolate);
327 template<typename T, typename P>
328 NAN_INLINE v8::Local<T> NanNew(P arg1) {
329 return T::New(nan_isolate, arg1);
333 NAN_INLINE v8::Local<v8::Signature> NanNew(
334 v8::Handle<v8::FunctionTemplate> receiver
336 , v8::Handle<v8::FunctionTemplate> argv[] = 0) {
337 return v8::Signature::New(nan_isolate, receiver, argc, argv);
341 NAN_INLINE v8::Local<v8::FunctionTemplate> NanNew(
342 NanFunctionCallback callback
343 , v8::Handle<v8::Value> data = v8::Handle<v8::Value>()
344 , v8::Handle<v8::Signature> signature = v8::Handle<v8::Signature>()) {
345 return T::New(nan_isolate, callback, data, signature);
349 NAN_INLINE v8::Local<T> NanNew(v8::Handle<T> arg1) {
350 return v8::Local<T>::New(nan_isolate, arg1);
354 NAN_INLINE v8::Local<T> NanNew(const v8::Persistent<T> &arg1) {
355 return v8::Local<T>::New(nan_isolate, arg1);
358 template<typename T, typename P>
359 NAN_INLINE v8::Local<T> NanNew(P arg1, int arg2) {
360 return T::New(nan_isolate, arg1, arg2);
364 NAN_INLINE v8::Local<v8::Array> NanNew<v8::Array>() {
365 return v8::Array::New(nan_isolate);
369 NAN_INLINE v8::Local<v8::Array> NanNew<v8::Array>(int length) {
370 return v8::Array::New(nan_isolate, length);
374 NAN_INLINE v8::Local<v8::Date> NanNew<v8::Date>(double time) {
375 return v8::Date::New(nan_isolate, time).As<v8::Date>();
379 NAN_INLINE v8::Local<v8::Date> NanNew<v8::Date>(int time) {
380 return v8::Date::New(nan_isolate, time).As<v8::Date>();
383 typedef v8::UnboundScript NanUnboundScript;
384 typedef v8::Script NanBoundScript;
386 template<typename T, typename P>
387 NAN_INLINE v8::Local<T> NanNew(
389 , const v8::ScriptOrigin& origin
391 v8::ScriptCompiler::Source source(s, origin);
392 return v8::ScriptCompiler::CompileUnbound(nan_isolate, &source);
396 NAN_INLINE v8::Local<NanUnboundScript> NanNew<NanUnboundScript>(
397 v8::Local<v8::String> s
399 v8::ScriptCompiler::Source source(s);
400 return v8::ScriptCompiler::CompileUnbound(nan_isolate, &source);
403 NAN_INLINE v8::Local<v8::String> NanNew(
404 v8::String::ExternalStringResource *resource) {
405 return v8::String::NewExternal(nan_isolate, resource);
408 NAN_INLINE v8::Local<v8::String> NanNew(
409 v8::String::ExternalAsciiStringResource *resource) {
410 return v8::String::NewExternal(nan_isolate, resource);
414 NAN_INLINE v8::Local<v8::BooleanObject> NanNew(bool value) {
415 return v8::BooleanObject::New(value).As<v8::BooleanObject>();
419 NAN_INLINE v8::Local<v8::StringObject>
420 NanNew<v8::StringObject, v8::Local<v8::String> >(
421 v8::Local<v8::String> value) {
422 return v8::StringObject::New(value).As<v8::StringObject>();
426 NAN_INLINE v8::Local<v8::StringObject>
427 NanNew<v8::StringObject, v8::Handle<v8::String> >(
428 v8::Handle<v8::String> value) {
429 return v8::StringObject::New(value).As<v8::StringObject>();
433 NAN_INLINE v8::Local<v8::NumberObject> NanNew<v8::NumberObject>(double val) {
434 return v8::NumberObject::New(nan_isolate, val).As<v8::NumberObject>();
438 NAN_INLINE v8::Local<v8::RegExp> NanNew(
439 v8::Handle<v8::String> pattern, v8::RegExp::Flags flags) {
440 return v8::RegExp::New(pattern, flags);
444 NAN_INLINE v8::Local<v8::RegExp> NanNew(
445 v8::Local<v8::String> pattern, v8::RegExp::Flags flags) {
446 return v8::RegExp::New(pattern, flags);
449 template<typename T, typename P>
450 NAN_INLINE v8::Local<v8::RegExp> NanNew(
451 v8::Handle<v8::String> pattern, v8::RegExp::Flags flags) {
452 return v8::RegExp::New(pattern, flags);
455 template<typename T, typename P>
456 NAN_INLINE v8::Local<v8::RegExp> NanNew(
457 v8::Local<v8::String> pattern, v8::RegExp::Flags flags) {
458 return v8::RegExp::New(pattern, flags);
462 NAN_INLINE v8::Local<v8::Uint32> NanNew<v8::Uint32, int32_t>(int32_t val) {
463 return v8::Uint32::NewFromUnsigned(nan_isolate, val)->ToUint32();
467 NAN_INLINE v8::Local<v8::Uint32> NanNew<v8::Uint32, uint32_t>(uint32_t val) {
468 return v8::Uint32::NewFromUnsigned(nan_isolate, val)->ToUint32();
472 NAN_INLINE v8::Local<v8::Int32> NanNew<v8::Int32, int32_t>(int32_t val) {
473 return v8::Int32::New(nan_isolate, val)->ToInt32();
477 NAN_INLINE v8::Local<v8::Int32> NanNew<v8::Int32, uint32_t>(uint32_t val) {
478 return v8::Int32::New(nan_isolate, val)->ToInt32();
482 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, char *>(
485 return v8::String::NewFromUtf8(
488 , v8::String::kNormalString
493 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const char *>(
496 return v8::String::NewFromUtf8(
499 , v8::String::kNormalString
504 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, char *>(char *arg) {
505 return v8::String::NewFromUtf8(nan_isolate, arg);
509 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const char *>(
511 return v8::String::NewFromUtf8(nan_isolate, arg);
515 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, uint8_t *>(
518 return v8::String::NewFromOneByte(
521 , v8::String::kNormalString
526 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const uint8_t *>(
529 return v8::String::NewFromOneByte(
532 , v8::String::kNormalString
537 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, uint8_t *>(uint8_t *arg) {
538 return v8::String::NewFromOneByte(nan_isolate, arg);
542 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const uint8_t *>(
543 const uint8_t *arg) {
544 return v8::String::NewFromOneByte(nan_isolate, arg);
548 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, uint16_t *>(
551 return v8::String::NewFromTwoByte(
554 , v8::String::kNormalString
559 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const uint16_t *>(
562 return v8::String::NewFromTwoByte(
565 , v8::String::kNormalString
569 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, uint16_t *>(
571 return v8::String::NewFromTwoByte(nan_isolate, arg);
575 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const uint16_t *>(
576 const uint16_t *arg) {
577 return v8::String::NewFromTwoByte(nan_isolate, arg);
581 NAN_INLINE v8::Local<v8::String> NanNew<v8::String>() {
582 return v8::String::Empty(nan_isolate);
585 NAN_INLINE void NanAddGCEpilogueCallback(
586 v8::Isolate::GCEpilogueCallback callback
587 , v8::GCType gc_type_filter = v8::kGCTypeAll) {
588 nan_isolate->AddGCEpilogueCallback(callback, gc_type_filter);
591 NAN_INLINE void NanRemoveGCEpilogueCallback(
592 v8::Isolate::GCEpilogueCallback callback) {
593 nan_isolate->RemoveGCEpilogueCallback(callback);
596 NAN_INLINE void NanAddGCPrologueCallback(
597 v8::Isolate::GCPrologueCallback callback
598 , v8::GCType gc_type_filter = v8::kGCTypeAll) {
599 nan_isolate->AddGCPrologueCallback(callback, gc_type_filter);
602 NAN_INLINE void NanRemoveGCPrologueCallback(
603 v8::Isolate::GCPrologueCallback callback) {
604 nan_isolate->RemoveGCPrologueCallback(callback);
607 NAN_INLINE void NanGetHeapStatistics(
608 v8::HeapStatistics *heap_statistics) {
609 nan_isolate->GetHeapStatistics(heap_statistics);
612 # define NanSymbol(value) NanNew<v8::String>(value)
615 NAN_INLINE void NanAssignPersistent(
616 v8::Persistent<T>& handle
617 , v8::Handle<T> obj) {
618 handle.Reset(nan_isolate, obj);
622 NAN_INLINE void NanAssignPersistent(
623 v8::Persistent<T>& handle
624 , const v8::Persistent<T>& obj) {
625 handle.Reset(nan_isolate, obj);
628 template<typename T, typename P>
629 struct _NanWeakCallbackInfo {
630 typedef void (*Callback)(
631 const v8::WeakCallbackData<T, _NanWeakCallbackInfo<T, P> >& data);
632 _NanWeakCallbackInfo(v8::Handle<T> handle, P* param, Callback cb)
633 : parameter(param), callback(cb) {
634 NanAssignPersistent(persistent, handle);
637 ~_NanWeakCallbackInfo() {
642 Callback const callback;
643 v8::Persistent<T> persistent;
646 template<typename T, typename P>
647 class _NanWeakCallbackData {
649 _NanWeakCallbackData(_NanWeakCallbackInfo<T, P> *info)
652 NAN_INLINE v8::Local<T> GetValue() const {
653 return NanNew(info_->persistent);
655 NAN_INLINE P* GetParameter() const { return info_->parameter; }
656 NAN_INLINE void Revive() const {
657 info_->persistent.SetWeak(info_, info_->callback);
660 NAN_INLINE void Dispose() const {
665 _NanWeakCallbackInfo<T, P>* info_;
668 // do not use for declaration
669 # define NAN_WEAK_CALLBACK(name) \
670 template<typename T, typename P> \
672 const v8::WeakCallbackData<T, _NanWeakCallbackInfo<T, P> > &data) { \
673 _NanWeakCallbackData<T, P> wcbd( \
674 data.GetParameter()); \
675 _Nan_Weak_Callback_ ## name(wcbd); \
678 template<typename T, typename P> \
679 NAN_INLINE void _Nan_Weak_Callback_ ## name( \
680 const _NanWeakCallbackData<T, P> &data)
682 # define NanScope() v8::HandleScope scope(nan_isolate)
683 # define NanEscapableScope() v8::EscapableHandleScope scope(nan_isolate)
684 # define NanEscapeScope(val) scope.Escape(val)
685 # define NanLocker() v8::Locker locker(nan_isolate)
686 # define NanUnlocker() v8::Unlocker unlocker(nan_isolate)
687 # define NanReturnValue(value) return args.GetReturnValue().Set(value)
688 # define NanReturnUndefined() return
689 # define NanReturnNull() return args.GetReturnValue().SetNull()
690 # define NanReturnEmptyString() return args.GetReturnValue().SetEmptyString()
692 # define NanObjectWrapHandle(obj) obj->handle()
694 template<typename T, typename P>
695 void NAN_INLINE NanMakeWeakPersistent(
698 , typename _NanWeakCallbackInfo<T, P>::Callback callback) {
699 _NanWeakCallbackInfo<T, P> *cbinfo =
700 new _NanWeakCallbackInfo<T, P>(handle, parameter, callback);
701 cbinfo->persistent.SetWeak(cbinfo, callback);
704 # define _NAN_ERROR(fun, errmsg) fun(NanNew<v8::String>(errmsg))
706 # define _NAN_THROW_ERROR(fun, errmsg) \
709 nan_isolate->ThrowException(_NAN_ERROR(fun, errmsg)); \
712 NAN_INLINE v8::Local<v8::Value> NanError(const char* errmsg) {
713 return _NAN_ERROR(v8::Exception::Error, errmsg);
716 NAN_INLINE void NanThrowError(const char* errmsg) {
717 _NAN_THROW_ERROR(v8::Exception::Error, errmsg);
720 NAN_INLINE void NanThrowError(v8::Handle<v8::Value> error) {
722 nan_isolate->ThrowException(error);
725 NAN_INLINE v8::Local<v8::Value> NanError(
727 , const int errorNumber
729 v8::Local<v8::Value> err = v8::Exception::Error(NanNew<v8::String>(msg));
730 v8::Local<v8::Object> obj = err.As<v8::Object>();
731 obj->Set(NanSymbol("code"), NanNew<v8::Integer>(errorNumber));
735 NAN_INLINE void NanThrowError(
737 , const int errorNumber
739 NanThrowError(NanError(msg, errorNumber));
742 NAN_INLINE v8::Local<v8::Value> NanTypeError(const char* errmsg) {
743 return _NAN_ERROR(v8::Exception::TypeError, errmsg);
746 NAN_INLINE void NanThrowTypeError(const char* errmsg) {
747 _NAN_THROW_ERROR(v8::Exception::TypeError, errmsg);
750 NAN_INLINE v8::Local<v8::Value> NanRangeError(const char* errmsg) {
751 return _NAN_ERROR(v8::Exception::RangeError, errmsg);
754 NAN_INLINE void NanThrowRangeError(const char* errmsg) {
755 _NAN_THROW_ERROR(v8::Exception::RangeError, errmsg);
758 template<typename T> NAN_INLINE void NanDisposePersistent(
759 v8::Persistent<T> &handle
764 NAN_INLINE v8::Local<v8::Object> NanNewBufferHandle (
767 , node::smalloc::FreeCallback callback
770 return node::Buffer::New(nan_isolate, data, length, callback, hint);
773 NAN_INLINE v8::Local<v8::Object> NanNewBufferHandle (
777 return node::Buffer::New(nan_isolate, data, size);
780 NAN_INLINE v8::Local<v8::Object> NanNewBufferHandle (uint32_t size) {
781 return node::Buffer::New(nan_isolate, size);
784 NAN_INLINE v8::Local<v8::Object> NanBufferUse(
788 return node::Buffer::Use(nan_isolate, data, size);
791 NAN_INLINE bool NanHasInstance(
792 v8::Persistent<v8::FunctionTemplate>& function_template
793 , v8::Handle<v8::Value> value
795 return NanNew(function_template)->HasInstance(value);
798 NAN_INLINE v8::Local<v8::Context> NanNewContextHandle(
799 v8::ExtensionConfiguration* extensions = NULL
800 , v8::Handle<v8::ObjectTemplate> tmpl = v8::Handle<v8::ObjectTemplate>()
801 , v8::Handle<v8::Value> obj = v8::Handle<v8::Value>()
803 return v8::Local<v8::Context>::New(
805 , v8::Context::New(nan_isolate, extensions, tmpl, obj)
809 NAN_INLINE v8::Local<NanBoundScript> NanCompileScript(
810 v8::Local<v8::String> s
811 , const v8::ScriptOrigin& origin
813 v8::ScriptCompiler::Source source(s, origin);
814 return v8::ScriptCompiler::Compile(nan_isolate, &source);
817 NAN_INLINE v8::Local<NanBoundScript> NanCompileScript(
818 v8::Local<v8::String> s
820 v8::ScriptCompiler::Source source(s);
821 return v8::ScriptCompiler::Compile(nan_isolate, &source);
824 NAN_INLINE v8::Local<v8::Value> NanRunScript(
825 v8::Local<NanUnboundScript> script
827 return script->BindToCurrentContext()->Run();
830 NAN_INLINE v8::Local<v8::Value> NanRunScript(
831 v8::Local<NanBoundScript> script
833 return script->Run();
839 # define _NAN_METHOD_ARGS_TYPE const v8::Arguments&
840 # define _NAN_METHOD_ARGS _NAN_METHOD_ARGS_TYPE args
841 # define _NAN_METHOD_RETURN_TYPE v8::Handle<v8::Value>
843 # define _NAN_GETTER_ARGS_TYPE const v8::AccessorInfo &
844 # define _NAN_GETTER_ARGS _NAN_GETTER_ARGS_TYPE args
845 # define _NAN_GETTER_RETURN_TYPE v8::Handle<v8::Value>
847 # define _NAN_SETTER_ARGS_TYPE const v8::AccessorInfo &
848 # define _NAN_SETTER_ARGS _NAN_SETTER_ARGS_TYPE args
849 # define _NAN_SETTER_RETURN_TYPE void
851 # define _NAN_PROPERTY_GETTER_ARGS_TYPE const v8::AccessorInfo&
852 # define _NAN_PROPERTY_GETTER_ARGS _NAN_PROPERTY_GETTER_ARGS_TYPE args
853 # define _NAN_PROPERTY_GETTER_RETURN_TYPE v8::Handle<v8::Value>
855 # define _NAN_PROPERTY_SETTER_ARGS_TYPE const v8::AccessorInfo&
856 # define _NAN_PROPERTY_SETTER_ARGS _NAN_PROPERTY_SETTER_ARGS_TYPE args
857 # define _NAN_PROPERTY_SETTER_RETURN_TYPE v8::Handle<v8::Value>
859 # define _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE const v8::AccessorInfo&
860 # define _NAN_PROPERTY_ENUMERATOR_ARGS _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE args
861 # define _NAN_PROPERTY_ENUMERATOR_RETURN_TYPE v8::Handle<v8::Array>
863 # define _NAN_PROPERTY_DELETER_ARGS_TYPE const v8::AccessorInfo&
864 # define _NAN_PROPERTY_DELETER_ARGS _NAN_PROPERTY_DELETER_ARGS_TYPE args
865 # define _NAN_PROPERTY_DELETER_RETURN_TYPE v8::Handle<v8::Boolean>
867 # define _NAN_PROPERTY_QUERY_ARGS_TYPE const v8::AccessorInfo&
868 # define _NAN_PROPERTY_QUERY_ARGS _NAN_PROPERTY_QUERY_ARGS_TYPE args
869 # define _NAN_PROPERTY_QUERY_RETURN_TYPE v8::Handle<v8::Integer>
871 # define _NAN_INDEX_GETTER_ARGS_TYPE const v8::AccessorInfo&
872 # define _NAN_INDEX_GETTER_ARGS _NAN_INDEX_GETTER_ARGS_TYPE args
873 # define _NAN_INDEX_GETTER_RETURN_TYPE v8::Handle<v8::Value>
875 # define _NAN_INDEX_SETTER_ARGS_TYPE const v8::AccessorInfo&
876 # define _NAN_INDEX_SETTER_ARGS _NAN_INDEX_SETTER_ARGS_TYPE args
877 # define _NAN_INDEX_SETTER_RETURN_TYPE v8::Handle<v8::Value>
879 # define _NAN_INDEX_ENUMERATOR_ARGS_TYPE const v8::AccessorInfo&
880 # define _NAN_INDEX_ENUMERATOR_ARGS _NAN_INDEX_ENUMERATOR_ARGS_TYPE args
881 # define _NAN_INDEX_ENUMERATOR_RETURN_TYPE v8::Handle<v8::Array>
883 # define _NAN_INDEX_DELETER_ARGS_TYPE const v8::AccessorInfo&
884 # define _NAN_INDEX_DELETER_ARGS _NAN_INDEX_DELETER_ARGS_TYPE args
885 # define _NAN_INDEX_DELETER_RETURN_TYPE v8::Handle<v8::Boolean>
887 # define _NAN_INDEX_QUERY_ARGS_TYPE const v8::AccessorInfo&
888 # define _NAN_INDEX_QUERY_ARGS _NAN_INDEX_QUERY_ARGS_TYPE args
889 # define _NAN_INDEX_QUERY_RETURN_TYPE v8::Handle<v8::Integer>
891 typedef v8::InvocationCallback NanFunctionCallback;
893 # define NanUndefined() v8::Undefined()
894 # define NanNull() v8::Null()
895 # define NanTrue() v8::True()
896 # define NanFalse() v8::False()
897 # define NanAdjustExternalMemory(amount) \
898 v8::V8::AdjustAmountOfExternalAllocatedMemory(amount)
899 # define NanSetTemplate(templ, name, value) templ->Set(name, value)
900 # define NanGetCurrentContext() v8::Context::GetCurrent()
901 # if NODE_VERSION_AT_LEAST(0, 8, 0)
902 # define NanMakeCallback(target, func, argc, argv) \
903 node::MakeCallback(target, func, argc, argv)
905 # define NanMakeCallback(target, func, argc, argv) \
907 v8::TryCatch try_catch; \
908 func->Call(target, argc, argv); \
909 if (try_catch.HasCaught()) { \
910 v8::FatalException(try_catch); \
915 # define NanSymbol(value) v8::String::NewSymbol(value)
918 NAN_INLINE v8::Local<T> NanNew() {
919 return v8::Local<T>::New(T::New());
923 NAN_INLINE v8::Local<T> NanNew(v8::Handle<T> arg) {
924 return v8::Local<T>::New(arg);
928 NAN_INLINE v8::Local<v8::Signature> NanNew(
929 v8::Handle<v8::FunctionTemplate> receiver
931 , v8::Handle<v8::FunctionTemplate> argv[] = 0) {
932 return v8::Signature::New(receiver, argc, argv);
936 NAN_INLINE v8::Local<v8::FunctionTemplate> NanNew(
937 NanFunctionCallback callback
938 , v8::Handle<v8::Value> data = v8::Handle<v8::Value>()
939 , v8::Handle<v8::Signature> signature = v8::Handle<v8::Signature>()) {
940 return T::New(callback, data, signature);
944 NAN_INLINE v8::Local<T> NanNew(const v8::Persistent<T> &arg) {
945 return v8::Local<T>::New(arg);
948 template<typename T, typename P>
949 NAN_INLINE v8::Local<T> NanNew(P arg) {
950 return v8::Local<T>::New(T::New(arg));
953 template<typename T, typename P>
954 NAN_INLINE v8::Local<T> NanNew(P arg, int length) {
955 return v8::Local<T>::New(T::New(arg, length));
959 NAN_INLINE v8::Local<v8::RegExp> NanNew(
960 v8::Handle<v8::String> pattern, v8::RegExp::Flags flags) {
961 return v8::RegExp::New(pattern, flags);
965 NAN_INLINE v8::Local<v8::RegExp> NanNew(
966 v8::Local<v8::String> pattern, v8::RegExp::Flags flags) {
967 return v8::RegExp::New(pattern, flags);
970 template<typename T, typename P>
971 NAN_INLINE v8::Local<v8::RegExp> NanNew(
972 v8::Handle<v8::String> pattern, v8::RegExp::Flags flags) {
973 return v8::RegExp::New(pattern, flags);
976 template<typename T, typename P>
977 NAN_INLINE v8::Local<v8::RegExp> NanNew(
978 v8::Local<v8::String> pattern, v8::RegExp::Flags flags) {
979 return v8::RegExp::New(pattern, flags);
983 NAN_INLINE v8::Local<v8::Array> NanNew<v8::Array>() {
984 return v8::Array::New();
988 NAN_INLINE v8::Local<v8::Array> NanNew<v8::Array>(int length) {
989 return v8::Array::New(length);
994 NAN_INLINE v8::Local<v8::Date> NanNew<v8::Date>(double time) {
995 return v8::Date::New(time).As<v8::Date>();
999 NAN_INLINE v8::Local<v8::Date> NanNew<v8::Date>(int time) {
1000 return v8::Date::New(time).As<v8::Date>();
1003 typedef v8::Script NanUnboundScript;
1004 typedef v8::Script NanBoundScript;
1006 template<typename T, typename P>
1007 NAN_INLINE v8::Local<T> NanNew(
1009 , const v8::ScriptOrigin& origin
1011 return v8::Script::New(s, const_cast<v8::ScriptOrigin *>(&origin));
1015 NAN_INLINE v8::Local<NanUnboundScript> NanNew<NanUnboundScript>(
1016 v8::Local<v8::String> s
1018 return v8::Script::New(s);
1021 NAN_INLINE v8::Local<v8::String> NanNew(
1022 v8::String::ExternalStringResource *resource) {
1023 return v8::String::NewExternal(resource);
1026 NAN_INLINE v8::Local<v8::String> NanNew(
1027 v8::String::ExternalAsciiStringResource *resource) {
1028 return v8::String::NewExternal(resource);
1032 NAN_INLINE v8::Local<v8::BooleanObject> NanNew(bool value) {
1033 return v8::BooleanObject::New(value).As<v8::BooleanObject>();
1037 NAN_INLINE v8::Local<v8::StringObject>
1038 NanNew<v8::StringObject, v8::Local<v8::String> >(
1039 v8::Local<v8::String> value) {
1040 return v8::StringObject::New(value).As<v8::StringObject>();
1044 NAN_INLINE v8::Local<v8::StringObject>
1045 NanNew<v8::StringObject, v8::Handle<v8::String> >(
1046 v8::Handle<v8::String> value) {
1047 return v8::StringObject::New(value).As<v8::StringObject>();
1051 NAN_INLINE v8::Local<v8::NumberObject> NanNew<v8::NumberObject>(double val) {
1052 return v8::NumberObject::New(val).As<v8::NumberObject>();
1056 NAN_INLINE v8::Local<v8::Uint32> NanNew<v8::Uint32, int32_t>(int32_t val) {
1057 return v8::Uint32::NewFromUnsigned(val)->ToUint32();
1061 NAN_INLINE v8::Local<v8::Uint32> NanNew<v8::Uint32, uint32_t>(uint32_t val) {
1062 return v8::Uint32::NewFromUnsigned(val)->ToUint32();
1066 NAN_INLINE v8::Local<v8::Int32> NanNew<v8::Int32, int32_t>(int32_t val) {
1067 return v8::Int32::New(val)->ToInt32();
1071 NAN_INLINE v8::Local<v8::Int32> NanNew<v8::Int32, uint32_t>(uint32_t val) {
1072 return v8::Int32::New(val)->ToInt32();
1076 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, uint8_t *>(
1079 uint16_t *warg = new uint16_t[length];
1080 for (int i = 0; i < length; i++) {
1083 v8::Local<v8::String> retval = v8::String::New(warg, length);
1089 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const uint8_t *>(
1092 uint16_t *warg = new uint16_t[length];
1093 for (int i = 0; i < length; i++) {
1096 v8::Local<v8::String> retval = v8::String::New(warg, length);
1102 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, uint8_t *>(uint8_t *arg) {
1103 int length = strlen(reinterpret_cast<char *>(arg));
1104 uint16_t *warg = new uint16_t[length];
1105 for (int i = 0; i < length; i++) {
1109 v8::Local<v8::String> retval = v8::String::New(warg, length);
1115 NAN_INLINE v8::Local<v8::String> NanNew<v8::String, const uint8_t *>(
1116 const uint8_t *arg) {
1117 int length = strlen(reinterpret_cast<const char *>(arg));
1118 uint16_t *warg = new uint16_t[length];
1119 for (int i = 0; i < length; i++) {
1122 v8::Local<v8::String> retval = v8::String::New(warg, length);
1128 NAN_INLINE v8::Local<v8::String> NanNew<v8::String>() {
1129 return v8::String::Empty();
1132 NAN_INLINE void NanAddGCEpilogueCallback(
1133 v8::GCEpilogueCallback callback
1134 , v8::GCType gc_type_filter = v8::kGCTypeAll) {
1135 v8::V8::AddGCEpilogueCallback(callback, gc_type_filter);
1137 NAN_INLINE void NanRemoveGCEpilogueCallback(
1138 v8::GCEpilogueCallback callback) {
1139 v8::V8::RemoveGCEpilogueCallback(callback);
1141 NAN_INLINE void NanAddGCPrologueCallback(
1142 v8::GCPrologueCallback callback
1143 , v8::GCType gc_type_filter = v8::kGCTypeAll) {
1144 v8::V8::AddGCPrologueCallback(callback, gc_type_filter);
1146 NAN_INLINE void NanRemoveGCPrologueCallback(
1147 v8::GCPrologueCallback callback) {
1148 v8::V8::RemoveGCPrologueCallback(callback);
1150 NAN_INLINE void NanGetHeapStatistics(
1151 v8::HeapStatistics *heap_statistics) {
1152 v8::V8::GetHeapStatistics(heap_statistics);
1155 template<typename T>
1156 NAN_INLINE void NanAssignPersistent(
1157 v8::Persistent<T>& handle
1158 , v8::Handle<T> obj) {
1160 handle = v8::Persistent<T>::New(obj);
1163 template<typename T, typename P>
1164 struct _NanWeakCallbackInfo {
1165 typedef void (*Callback)(v8::Persistent<v8::Value> object, void* parameter);
1166 _NanWeakCallbackInfo(v8::Handle<T> handle, P* param, Callback cb) :
1169 , persistent(v8::Persistent<T>::New(handle)) { }
1171 ~_NanWeakCallbackInfo() {
1172 persistent.Dispose();
1177 Callback const callback;
1178 v8::Persistent<T> persistent;
1181 template<typename T, typename P>
1182 class _NanWeakCallbackData {
1184 _NanWeakCallbackData(_NanWeakCallbackInfo<T, P> *info)
1187 NAN_INLINE v8::Local<T> GetValue() const {
1188 return NanNew(info_->persistent);
1190 NAN_INLINE P* GetParameter() const { return info_->parameter; }
1191 NAN_INLINE void Revive() const {
1192 info_->persistent.MakeWeak(info_, info_->callback);
1194 NAN_INLINE void Dispose() const {
1199 _NanWeakCallbackInfo<T, P>* info_;
1202 # define NanGetInternalFieldPointer(object, index) \
1203 object->GetPointerFromInternalField(index)
1204 # define NanSetInternalFieldPointer(object, index, value) \
1205 object->SetPointerInInternalField(index, value)
1207 // do not use for declaration
1208 # define NAN_WEAK_CALLBACK(name) \
1209 template<typename T, typename P> \
1211 v8::Persistent<v8::Value> object, void *data) { \
1212 _NanWeakCallbackData<T, P> wcbd( \
1213 static_cast<_NanWeakCallbackInfo<T, P>*>(data)); \
1214 _Nan_Weak_Callback_ ## name(wcbd); \
1217 template<typename T, typename P> \
1218 NAN_INLINE void _Nan_Weak_Callback_ ## name( \
1219 const _NanWeakCallbackData<T, P> &data)
1221 template<typename T, typename P>
1222 NAN_INLINE void NanMakeWeakPersistent(
1223 v8::Handle<T> handle
1225 , typename _NanWeakCallbackInfo<T, P>::Callback callback) {
1226 _NanWeakCallbackInfo<T, P> *cbinfo =
1227 new _NanWeakCallbackInfo<T, P>(handle, parameter, callback);
1228 cbinfo->persistent.MakeWeak(cbinfo, callback);
1231 # define NanScope() v8::HandleScope scope
1232 # define NanEscapableScope() v8::HandleScope scope
1233 # define NanEscapeScope(val) scope.Close(val)
1234 # define NanLocker() v8::Locker locker
1235 # define NanUnlocker() v8::Unlocker unlocker
1236 # define NanReturnValue(value) return scope.Close(value)
1237 # define NanReturnUndefined() return v8::Undefined()
1238 # define NanReturnNull() return v8::Null()
1239 # define NanReturnEmptyString() return v8::String::Empty()
1240 # define NanObjectWrapHandle(obj) v8::Local<v8::Object>::New(obj->handle_)
1242 # define _NAN_ERROR(fun, errmsg) \
1243 fun(v8::String::New(errmsg))
1245 # define _NAN_THROW_ERROR(fun, errmsg) \
1248 return v8::Local<v8::Value>::New( \
1249 v8::ThrowException(_NAN_ERROR(fun, errmsg))); \
1252 NAN_INLINE v8::Local<v8::Value> NanError(const char* errmsg) {
1253 return _NAN_ERROR(v8::Exception::Error, errmsg);
1256 NAN_INLINE v8::Local<v8::Value> NanThrowError(const char* errmsg) {
1257 _NAN_THROW_ERROR(v8::Exception::Error, errmsg);
1260 NAN_INLINE v8::Local<v8::Value> NanThrowError(
1261 v8::Handle<v8::Value> error
1264 return v8::Local<v8::Value>::New(v8::ThrowException(error));
1267 NAN_INLINE v8::Local<v8::Value> NanError(
1269 , const int errorNumber
1271 v8::Local<v8::Value> err = v8::Exception::Error(v8::String::New(msg));
1272 v8::Local<v8::Object> obj = err.As<v8::Object>();
1273 obj->Set(v8::String::New("code"), v8::Int32::New(errorNumber));
1277 NAN_INLINE v8::Local<v8::Value> NanThrowError(
1279 , const int errorNumber
1281 return NanThrowError(NanError(msg, errorNumber));
1284 NAN_INLINE v8::Local<v8::Value> NanTypeError(const char* errmsg) {
1285 return _NAN_ERROR(v8::Exception::TypeError, errmsg);
1288 NAN_INLINE v8::Local<v8::Value> NanThrowTypeError(
1291 _NAN_THROW_ERROR(v8::Exception::TypeError, errmsg);
1294 NAN_INLINE v8::Local<v8::Value> NanRangeError(
1297 return _NAN_ERROR(v8::Exception::RangeError, errmsg);
1300 NAN_INLINE v8::Local<v8::Value> NanThrowRangeError(
1303 _NAN_THROW_ERROR(v8::Exception::RangeError, errmsg);
1306 template<typename T>
1307 NAN_INLINE void NanDisposePersistent(
1308 v8::Persistent<T> &handle) { // NOLINT(runtime/references)
1313 NAN_INLINE v8::Local<v8::Object> NanNewBufferHandle (
1316 , node::Buffer::free_callback callback
1319 return NanNew<v8::Object>(
1320 node::Buffer::New(data, length, callback, hint)->handle_);
1323 NAN_INLINE v8::Local<v8::Object> NanNewBufferHandle (
1327 #if NODE_MODULE_VERSION >= 0x000B
1328 return NanNew<v8::Object>(node::Buffer::New(data, size)->handle_);
1330 return NanNew<v8::Object>(
1331 node::Buffer::New(const_cast<char*>(data), size)->handle_);
1335 NAN_INLINE v8::Local<v8::Object> NanNewBufferHandle (uint32_t size) {
1336 return NanNew<v8::Object>(node::Buffer::New(size)->handle_);
1339 NAN_INLINE void FreeData(char *data, void *hint) {
1343 NAN_INLINE v8::Local<v8::Object> NanBufferUse(
1347 return NanNew<v8::Object>(
1348 node::Buffer::New(data, size, FreeData, NULL)->handle_);
1351 NAN_INLINE bool NanHasInstance(
1352 v8::Persistent<v8::FunctionTemplate>& function_template
1353 , v8::Handle<v8::Value> value
1355 return function_template->HasInstance(value);
1358 NAN_INLINE v8::Local<v8::Context> NanNewContextHandle(
1359 v8::ExtensionConfiguration* extensions = NULL
1360 , v8::Handle<v8::ObjectTemplate> tmpl = v8::Handle<v8::ObjectTemplate>()
1361 , v8::Handle<v8::Value> obj = v8::Handle<v8::Value>()
1363 v8::Persistent<v8::Context> ctx = v8::Context::New(extensions, tmpl, obj);
1364 v8::Local<v8::Context> lctx = NanNew<v8::Context>(ctx);
1369 NAN_INLINE v8::Local<NanBoundScript> NanCompileScript(
1370 v8::Local<v8::String> s
1371 , const v8::ScriptOrigin& origin
1373 return v8::Script::Compile(s, const_cast<v8::ScriptOrigin *>(&origin));
1376 NAN_INLINE v8::Local<NanBoundScript> NanCompileScript(
1377 v8::Local<v8::String> s
1379 return v8::Script::Compile(s);
1382 NAN_INLINE v8::Local<v8::Value> NanRunScript(v8::Local<v8::Script> script) {
1383 return script->Run();
1386 #endif // NODE_MODULE_VERSION
1388 typedef void (*NanFreeCallback)(char *data, void *hint);
1390 #define NAN_METHOD(name) _NAN_METHOD_RETURN_TYPE name(_NAN_METHOD_ARGS)
1391 #define NAN_GETTER(name) \
1392 _NAN_GETTER_RETURN_TYPE name( \
1393 v8::Local<v8::String> property \
1395 #define NAN_SETTER(name) \
1396 _NAN_SETTER_RETURN_TYPE name( \
1397 v8::Local<v8::String> property \
1398 , v8::Local<v8::Value> value \
1400 #define NAN_PROPERTY_GETTER(name) \
1401 _NAN_PROPERTY_GETTER_RETURN_TYPE name( \
1402 v8::Local<v8::String> property \
1403 , _NAN_PROPERTY_GETTER_ARGS)
1404 #define NAN_PROPERTY_SETTER(name) \
1405 _NAN_PROPERTY_SETTER_RETURN_TYPE name( \
1406 v8::Local<v8::String> property \
1407 , v8::Local<v8::Value> value \
1408 , _NAN_PROPERTY_SETTER_ARGS)
1409 #define NAN_PROPERTY_ENUMERATOR(name) \
1410 _NAN_PROPERTY_ENUMERATOR_RETURN_TYPE name(_NAN_PROPERTY_ENUMERATOR_ARGS)
1411 #define NAN_PROPERTY_DELETER(name) \
1412 _NAN_PROPERTY_DELETER_RETURN_TYPE name( \
1413 v8::Local<v8::String> property \
1414 , _NAN_PROPERTY_DELETER_ARGS)
1415 #define NAN_PROPERTY_QUERY(name) \
1416 _NAN_PROPERTY_QUERY_RETURN_TYPE name( \
1417 v8::Local<v8::String> property \
1418 , _NAN_PROPERTY_QUERY_ARGS)
1419 # define NAN_INDEX_GETTER(name) \
1420 _NAN_INDEX_GETTER_RETURN_TYPE name(uint32_t index, _NAN_INDEX_GETTER_ARGS)
1421 #define NAN_INDEX_SETTER(name) \
1422 _NAN_INDEX_SETTER_RETURN_TYPE name( \
1424 , v8::Local<v8::Value> value \
1425 , _NAN_INDEX_SETTER_ARGS)
1426 #define NAN_INDEX_ENUMERATOR(name) \
1427 _NAN_INDEX_ENUMERATOR_RETURN_TYPE name(_NAN_INDEX_ENUMERATOR_ARGS)
1428 #define NAN_INDEX_DELETER(name) \
1429 _NAN_INDEX_DELETER_RETURN_TYPE name( \
1431 , _NAN_INDEX_DELETER_ARGS)
1432 #define NAN_INDEX_QUERY(name) \
1433 _NAN_INDEX_QUERY_RETURN_TYPE name(uint32_t index, _NAN_INDEX_QUERY_ARGS)
1439 v8::Local<v8::Object> obj = NanNew<v8::Object>();
1440 NanAssignPersistent(handle, obj);
1443 explicit NanCallback(const v8::Handle<v8::Function> &fn) {
1445 v8::Local<v8::Object> obj = NanNew<v8::Object>();
1446 NanAssignPersistent(handle, obj);
1451 if (handle.IsEmpty()) return;
1452 NanDisposePersistent(handle);
1455 NAN_INLINE void SetFunction(const v8::Handle<v8::Function> &fn) {
1457 NanNew(handle)->Set(NanSymbol("callback"), fn);
1460 NAN_INLINE v8::Local<v8::Function> GetFunction () {
1461 return NanNew(handle)->Get(NanSymbol("callback"))
1462 .As<v8::Function>();
1465 void Call(int argc, v8::Handle<v8::Value> argv[]) {
1467 #if (NODE_MODULE_VERSION > 0x000B) // 0.11.12+
1468 v8::Local<v8::Function> callback = NanNew(handle)->
1469 Get(NanSymbol("callback")).As<v8::Function>();
1472 , nan_isolate->GetCurrentContext()->Global()
1478 #if NODE_VERSION_AT_LEAST(0, 8, 0)
1479 v8::Local<v8::Function> callback = NanNew(handle)->
1480 Get(NanSymbol("callback")).As<v8::Function>();
1482 v8::Context::GetCurrent()->Global()
1488 node::MakeCallback(handle, "callback", argc, argv);
1494 v8::Persistent<v8::Object> handle;
1497 /* abstract */ class NanAsyncWorker {
1499 explicit NanAsyncWorker(NanCallback *callback) : callback(callback) {
1500 request.data = this;
1504 v8::Local<v8::Object> obj = NanNew<v8::Object>();
1505 NanAssignPersistent(persistentHandle, obj);
1508 virtual ~NanAsyncWorker() {
1511 if (!persistentHandle.IsEmpty())
1512 NanDisposePersistent(persistentHandle);
1519 virtual void WorkComplete() {
1525 HandleErrorCallback();
1530 NAN_INLINE void SaveToPersistent(const char *key, v8::Local<v8::Object> &obj) {
1531 v8::Local<v8::Object> handle = NanNew(persistentHandle);
1532 handle->Set(NanSymbol(key), obj);
1535 v8::Local<v8::Object> GetFromPersistent(const char *key) {
1536 NanEscapableScope();
1537 v8::Local<v8::Object> handle = NanNew(persistentHandle);
1538 return NanEscapeScope(handle->Get(NanSymbol(key)).As<v8::Object>());
1541 virtual void Execute() = 0;
1546 v8::Persistent<v8::Object> persistentHandle;
1547 NanCallback *callback;
1550 virtual void HandleOKCallback() {
1553 callback->Call(0, NULL);
1556 virtual void HandleErrorCallback() {
1559 v8::Local<v8::Value> argv[] = {
1560 v8::Exception::Error(NanNew<v8::String>(errmsg))
1562 callback->Call(1, argv);
1566 NAN_INLINE void NanAsyncExecute (uv_work_t* req) {
1567 NanAsyncWorker *worker = static_cast<NanAsyncWorker*>(req->data);
1571 NAN_INLINE void NanAsyncExecuteComplete (uv_work_t* req) {
1572 NanAsyncWorker* worker = static_cast<NanAsyncWorker*>(req->data);
1573 worker->WorkComplete();
1577 NAN_INLINE void NanAsyncQueueWorker (NanAsyncWorker* worker) {
1582 , (uv_after_work_cb)NanAsyncExecuteComplete
1588 #define _nan_base64_encoded_size(size) ((size + 2 - ((size + 2) % 3)) / 3 * 4)
1590 // Doesn't check for padding at the end. Can be 1-2 bytes over.
1591 NAN_INLINE size_t _nan_base64_decoded_size_fast(size_t size) {
1592 size_t remainder = size % 4;
1594 size = (size / 4) * 3;
1596 if (size == 0 && remainder == 1) {
1597 // special case: 1-byte input cannot be decoded
1600 // non-padded input, add 1 or 2 extra bytes
1601 size += 1 + (remainder == 3);
1608 template<typename T>
1609 NAN_INLINE size_t _nan_base64_decoded_size(
1616 if (src[size - 1] == '=')
1618 if (size > 0 && src[size - 1] == '=')
1621 return _nan_base64_decoded_size_fast(size);
1624 // supports regular and URL-safe base64
1625 static const int _nan_unbase64_table[] = {
1626 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -2, -1, -1, -2, -1, -1
1627 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1628 , -2, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 62, -1, 62, -1, 63
1629 , 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, -1, -1, -1, -1, -1, -1
1630 , -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14
1631 , 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, -1, -1, -1, -1, 63
1632 , -1, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40
1633 , 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, -1, -1, -1, -1, -1
1634 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1635 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1636 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1637 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1638 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1639 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1640 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1641 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
1644 #define _nan_unbase64(x) _nan_unbase64_table[(uint8_t)(x)]
1646 template<typename T> static size_t _nan_base64_decode(
1650 , const size_t srcLen
1653 char* dstEnd = buf + len;
1654 const T* srcEnd = src + srcLen;
1656 while (src < srcEnd && dst < dstEnd) {
1657 ptrdiff_t remaining = srcEnd - src;
1660 while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--;
1661 if (remaining == 0 || *src == '=') break;
1662 a = _nan_unbase64(*src++);
1664 while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--;
1665 if (remaining <= 1 || *src == '=') break;
1666 b = _nan_unbase64(*src++);
1668 *dst++ = (a << 2) | ((b & 0x30) >> 4);
1669 if (dst == dstEnd) break;
1671 while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--;
1672 if (remaining <= 2 || *src == '=') break;
1673 c = _nan_unbase64(*src++);
1675 *dst++ = ((b & 0x0F) << 4) | ((c & 0x3C) >> 2);
1676 if (dst == dstEnd) break;
1678 while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--;
1679 if (remaining <= 3 || *src == '=') break;
1680 d = _nan_unbase64(*src++);
1682 *dst++ = ((c & 0x03) << 6) | (d & 0x3F);
1690 template<typename T> unsigned _nan_hex2bin(T c) {
1691 if (c >= '0' && c <= '9') return c - '0';
1692 if (c >= 'A' && c <= 'F') return 10 + (c - 'A');
1693 if (c >= 'a' && c <= 'f') return 10 + (c - 'a');
1694 return static_cast<unsigned>(-1);
1697 template<typename T> static size_t _nan_hex_decode(
1701 , const size_t srcLen
1704 for (i = 0; i < len && i * 2 + 1 < srcLen; ++i) {
1705 unsigned a = _nan_hex2bin(src[i * 2 + 0]);
1706 unsigned b = _nan_hex2bin(src[i * 2 + 1]);
1707 if (!~a || !~b) return i;
1708 buf[i] = a * 16 + b;
1714 static bool _NanGetExternalParts(
1715 v8::Handle<v8::Value> val
1719 if (node::Buffer::HasInstance(val)) {
1720 *data = node::Buffer::Data(val.As<v8::Object>());
1721 *len = node::Buffer::Length(val.As<v8::Object>());
1725 assert(val->IsString());
1726 v8::Local<v8::String> str = NanNew<v8::String>(val.As<v8::String>());
1728 if (str->IsExternalAscii()) {
1729 const v8::String::ExternalAsciiStringResource* ext;
1730 ext = str->GetExternalAsciiStringResource();
1731 *data = ext->data();
1732 *len = ext->length();
1735 } else if (str->IsExternal()) {
1736 const v8::String::ExternalStringResource* ext;
1737 ext = str->GetExternalStringResource();
1738 *data = reinterpret_cast<const char*>(ext->data());
1739 *len = ext->length();
1747 enum Encoding {ASCII, UTF8, BASE64, UCS2, BINARY, HEX, BUFFER};
1750 NAN_INLINE void* NanRawString(
1751 v8::Handle<v8::Value> from
1752 , enum Nan::Encoding encoding
1761 size_t term_len = !(flags & v8::String::NO_NULL_TERMINATION);
1764 bool is_extern = _NanGetExternalParts(
1766 , const_cast<const char**>(&data)
1769 if (is_extern && !term_len) {
1770 NanSetPointerSafe(datalen, len);
1774 v8::Local<v8::String> toStr = from->ToString();
1776 char *to = static_cast<char *>(buf);
1780 #if NODE_MODULE_VERSION < 0x000C
1781 sz_ = toStr->Length();
1783 to = new char[sz_ + term_len];
1785 assert(buflen >= sz_ + term_len && "too small buffer");
1787 NanSetPointerSafe<size_t>(
1789 , toStr->WriteAscii(to, 0, static_cast<int>(sz_ + term_len), flags));
1794 sz_ = toStr->Length();
1796 to = new char[sz_ + term_len];
1798 assert(buflen >= sz_ + term_len && "too small buffer");
1800 #if NODE_MODULE_VERSION < 0x000C
1802 uint16_t* twobytebuf = new uint16_t[sz_ + term_len];
1804 size_t len = toStr->Write(twobytebuf, 0,
1805 static_cast<int>(sz_ + term_len), flags);
1807 for (size_t i = 0; i < sz_ + term_len && i < len + term_len; i++) {
1808 unsigned char *b = reinterpret_cast<unsigned char*>(&twobytebuf[i]);
1812 NanSetPointerSafe<size_t>(datalen, len);
1814 delete[] twobytebuf;
1818 NanSetPointerSafe<size_t>(
1820 toStr->WriteOneByte(
1821 reinterpret_cast<uint8_t *>(to)
1823 , static_cast<int>(sz_ + term_len)
1828 sz_ = toStr->Utf8Length();
1830 to = new char[sz_ + term_len];
1832 assert(buflen >= sz_ + term_len && "too small buffer");
1834 NanSetPointerSafe<size_t>(
1836 , toStr->WriteUtf8(to, static_cast<int>(sz_ + term_len)
1842 v8::String::Value value(toStr);
1843 sz_ = _nan_base64_decoded_size(*value, value.length());
1845 to = new char[sz_ + term_len];
1847 assert(buflen >= sz_ + term_len);
1849 NanSetPointerSafe<size_t>(
1851 , _nan_base64_decode(to, sz_, *value, value.length()));
1859 sz_ = toStr->Length();
1861 to = new char[(sz_ + term_len) * 2];
1863 assert(buflen >= (sz_ + term_len) * 2 && "too small buffer");
1866 int bc = 2 * toStr->Write(
1867 reinterpret_cast<uint16_t *>(to)
1869 , static_cast<int>(sz_ + term_len)
1871 NanSetPointerSafe<size_t>(datalen, bc);
1876 v8::String::Value value(toStr);
1877 sz_ = value.length();
1878 assert(!(sz_ & 1) && "bad hex data");
1880 to = new char[sz_ / 2 + term_len];
1882 assert(buflen >= sz_ / 2 + term_len && "too small buffer");
1884 NanSetPointerSafe<size_t>(
1886 , _nan_hex_decode(to, sz_ / 2, *value, value.length()));
1893 assert(0 && "unknown encoding");
1898 NAN_INLINE char* NanCString(
1899 v8::Handle<v8::Value> from
1903 , int flags = v8::String::NO_OPTIONS
1905 return static_cast<char *>(
1906 NanRawString(from, Nan::UTF8, datalen, buf, buflen, flags)