/********************************************************************************** * NAN - Native Abstractions for Node.js * * Copyright (c) 2014 NAN contributors: * - Rod Vagg * - Benjamin Byholm * - Trevor Norris * - Nathan Rajlich * - Brett Lawson * - Ben Noordhuis * * MIT +no-false-attribs License * * Version 0.8.0 (current Node unstable: 0.11.10, Node stable: 0.10.24) * * ChangeLog: * * 0.8.0 Jan 9 2014 * - NanDispose -> NanDisposePersistent, deprecate NanDispose * - Extract _NAN_*_RETURN_TYPE, pull up NAN_*() * * * 0.7.1 Jan 9 2014 * - Fixes to work against debug builds of Node * - Safer NanPersistentToLocal (avoid reinterpret_cast) * - Speed up common NanRawString case by only extracting flattened string when necessary * * * 0.7.0 Dec 17 2013 * - New no-arg form of NanCallback() constructor. * - NanCallback#Call takes Handle rather than Local * - Removed deprecated NanCallback#Run method, use NanCallback#Call instead * - Split off _NAN_*_ARGS_TYPE from _NAN_*_ARGS * - Restore (unofficial) Node 0.6 compatibility at NanCallback#Call() * - Introduce NanRawString() for char* (or appropriate void*) from v8::String * (replacement for NanFromV8String) * - Introduce NanCString() for null-terminated char* from v8::String * * * 0.6.0 Nov 21 2013 * - Introduce NanNewLocal(v8::Handle value) for use in place of * v8::Local::New(...) since v8 started requiring isolate in Node 0.11.9 * * * 0.5.2 Nov 16 2013 * - Convert SavePersistent and GetFromPersistent in NanAsyncWorker from protected and public * * * 0.5.1 Nov 12 2013 * - Use node::MakeCallback() instead of direct v8::Function::Call() * * * 0.5.0 Nov 11 2013 * - Added @TooTallNate as collaborator * - New, much simpler, "include_dirs" for binding.gyp * - Added full range of NAN_INDEX_* macros to match NAN_PROPERTY_* macros * * * 0.4.4 Nov 2 2013 * - Isolate argument from v8::Persistent::MakeWeak removed for 0.11.8+ * * * 0.4.3 Nov 2 2013 * - Include node_object_wrap.h, removed from node.h for Node 0.11.8. * * * 0.4.2 Nov 2 2013 * - Handle deprecation of v8::Persistent::Dispose(v8::Isolate* isolate)) for * Node 0.11.8 release. * * * 0.4.1 Sep 16 2013 * - Added explicit `#include ` as it was removed from node.h for v0.11.8 * * * 0.4.0 Sep 2 2013 * - Added NAN_INLINE and NAN_DEPRECATED and made use of them * - Added NanError, NanTypeError and NanRangeError * - Cleaned up code * * * 0.3.2 Aug 30 2013 * - Fix missing scope declaration in GetFromPersistent() and SaveToPersistent * in NanAsyncWorker * * * 0.3.1 Aug 20 2013 * - fix "not all control paths return a value" compile warning on some platforms * * * 0.3.0 Aug 19 2013 * - Made NAN work with NPM * - Lots of fixes to NanFromV8String, pulling in features from new Node core * - Changed node::encoding to Nan::Encoding in NanFromV8String to unify the API * - Added optional error number argument for NanThrowError() * - Added NanInitPersistent() * - Added NanReturnNull() and NanReturnEmptyString() * - Added NanLocker and NanUnlocker * - Added missing scopes * - Made sure to clear disposed Persistent handles * - Changed NanAsyncWorker to allocate error messages on the heap * - Changed NanThrowError(Local) to NanThrowError(Handle) * - Fixed leak in NanAsyncWorker when errmsg is used * * * 0.2.2 Aug 5 2013 * - Fixed usage of undefined variable with node::BASE64 in NanFromV8String() * * * 0.2.1 Aug 5 2013 * - Fixed 0.8 breakage, node::BUFFER encoding type not available in 0.8 for * NanFromV8String() * * * 0.2.0 Aug 5 2013 * - Added NAN_PROPERTY_GETTER, NAN_PROPERTY_SETTER, NAN_PROPERTY_ENUMERATOR, * NAN_PROPERTY_DELETER, NAN_PROPERTY_QUERY * - Extracted _NAN_METHOD_ARGS, _NAN_GETTER_ARGS, _NAN_SETTER_ARGS, * _NAN_PROPERTY_GETTER_ARGS, _NAN_PROPERTY_SETTER_ARGS, * _NAN_PROPERTY_ENUMERATOR_ARGS, _NAN_PROPERTY_DELETER_ARGS, * _NAN_PROPERTY_QUERY_ARGS * - Added NanGetInternalFieldPointer, NanSetInternalFieldPointer * - Added NAN_WEAK_CALLBACK, NAN_WEAK_CALLBACK_OBJECT, * NAN_WEAK_CALLBACK_DATA, NanMakeWeak * - Renamed THROW_ERROR to _NAN_THROW_ERROR * - Added NanNewBufferHandle(char*, size_t, node::smalloc::FreeCallback, void*) * - Added NanBufferUse(char*, uint32_t) * - Added NanNewContextHandle(v8::ExtensionConfiguration*, * v8::Handle, v8::Handle) * - Fixed broken NanCallback#GetFunction() * - Added optional encoding and size arguments to NanFromV8String() * - Added NanGetPointerSafe() and NanSetPointerSafe() * - Added initial test suite (to be expanded) * - Allow NanUInt32OptionValue to convert any Number object * * * 0.1.0 Jul 21 2013 * - Added `NAN_GETTER`, `NAN_SETTER` * - Added `NanThrowError` with single Local argument * - Added `NanNewBufferHandle` with single uint32_t argument * - Added `NanHasInstance(Persistent&, Handle)` * - Added `Local NanCallback#GetFunction()` * - Added `NanCallback#Call(int, Local[])` * - Deprecated `NanCallback#Run(int, Local[])` in favour of Call * * See https://github.com/rvagg/nan for the latest update to this file **********************************************************************************/ #ifndef NAN_H #define NAN_H #include #include #include #include #include #include #if defined(__GNUC__) && !defined(DEBUG) # define NAN_INLINE(declarator) inline __attribute__((always_inline)) declarator #elif defined(_MSC_VER) && !defined(DEBUG) # define NAN_INLINE(declarator) __forceinline declarator #else # define NAN_INLINE(declarator) inline declarator #endif #if defined(__GNUC__) && !V8_DISABLE_DEPRECATIONS # define NAN_DEPRECATED(declarator) __attribute__((deprecated)) declarator #elif defined(_MSC_VER) && !V8_DISABLE_DEPRECATIONS # define NAN_DEPRECATED(declarator) __declspec(deprecated) declarator #else # define NAN_DEPRECATED(declarator) declarator #endif // some generic helpers template static NAN_INLINE(bool NanSetPointerSafe( T *var , T val )) { if (var) { *var = val; return true; } else { return false; } } template static NAN_INLINE(T NanGetPointerSafe( T *var , T fallback = reinterpret_cast(0) )) { if (var) { return *var; } else { return fallback; } } #define NanSymbol(value) v8::String::NewSymbol(value) static NAN_INLINE(bool NanBooleanOptionValue( v8::Local optionsObj , v8::Handle opt, bool def )) { if (def) { return optionsObj.IsEmpty() || !optionsObj->Has(opt) || optionsObj->Get(opt)->BooleanValue(); } else { return !optionsObj.IsEmpty() && optionsObj->Has(opt) && optionsObj->Get(opt)->BooleanValue(); } } static NAN_INLINE(bool NanBooleanOptionValue( v8::Local optionsObj , v8::Handle opt )) { return NanBooleanOptionValue(optionsObj, opt, false); } static NAN_INLINE(uint32_t NanUInt32OptionValue( v8::Local optionsObj , v8::Handle opt , uint32_t def )) { return !optionsObj.IsEmpty() && optionsObj->Has(opt) && optionsObj->Get(opt)->IsNumber() ? optionsObj->Get(opt)->Uint32Value() : def; } #if (NODE_MODULE_VERSION > 0x000B) // Node 0.11+ (0.11.3 and below won't compile with these) static v8::Isolate* nan_isolate = v8::Isolate::GetCurrent(); # define _NAN_METHOD_ARGS_TYPE const v8::FunctionCallbackInfo& # define _NAN_METHOD_ARGS _NAN_METHOD_ARGS_TYPE args # define _NAN_METHOD_RETURN_TYPE void # define _NAN_GETTER_ARGS_TYPE const v8::PropertyCallbackInfo& # define _NAN_GETTER_ARGS _NAN_GETTER_ARGS_TYPE args # define _NAN_GETTER_RETURN_TYPE void # define _NAN_SETTER_ARGS_TYPE const v8::PropertyCallbackInfo& # define _NAN_SETTER_ARGS _NAN_SETTER_ARGS_TYPE args # define _NAN_SETTER_RETURN_TYPE void # define _NAN_PROPERTY_GETTER_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_PROPERTY_GETTER_ARGS _NAN_PROPERTY_GETTER_ARGS_TYPE args # define _NAN_PROPERTY_GETTER_RETURN_TYPE void # define _NAN_PROPERTY_SETTER_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_PROPERTY_SETTER_ARGS _NAN_PROPERTY_SETTER_ARGS_TYPE args # define _NAN_PROPERTY_SETTER_RETURN_TYPE void # define _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_PROPERTY_ENUMERATOR_ARGS _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE args # define _NAN_PROPERTY_ENUMERATOR_RETURN_TYPE void # define _NAN_PROPERTY_DELETER_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_PROPERTY_DELETER_ARGS \ _NAN_PROPERTY_DELETER_ARGS_TYPE args # define _NAN_PROPERTY_DELETER_RETURN_TYPE void # define _NAN_PROPERTY_QUERY_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_PROPERTY_QUERY_ARGS _NAN_PROPERTY_QUERY_ARGS_TYPE args # define _NAN_PROPERTY_QUERY_RETURN_TYPE void # define _NAN_INDEX_GETTER_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_INDEX_GETTER_ARGS _NAN_INDEX_GETTER_ARGS_TYPE args # define _NAN_INDEX_GETTER_RETURN_TYPE void # define _NAN_INDEX_SETTER_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_INDEX_SETTER_ARGS _NAN_INDEX_SETTER_ARGS_TYPE args # define _NAN_INDEX_SETTER_RETURN_TYPE void # define _NAN_INDEX_ENUMERATOR_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_INDEX_ENUMERATOR_ARGS _NAN_INDEX_ENUMERATOR_ARGS_TYPE args # define _NAN_INDEX_ENUMERATOR_RETURN_TYPE void # define _NAN_INDEX_DELETER_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_INDEX_DELETER_ARGS _NAN_INDEX_DELETER_ARGS_TYPE args # define _NAN_INDEX_DELETER_RETURN_TYPE void # define _NAN_INDEX_QUERY_ARGS_TYPE \ const v8::PropertyCallbackInfo& # define _NAN_INDEX_QUERY_ARGS _NAN_INDEX_QUERY_ARGS_TYPE args # define _NAN_INDEX_QUERY_RETURN_TYPE void # define NanGetInternalFieldPointer(object, index) \ object->GetAlignedPointerFromInternalField(index) # define NanSetInternalFieldPointer(object, index, value) \ object->SetAlignedPointerInInternalField(index, value) # define NAN_WEAK_CALLBACK(type, name) \ void name( \ v8::Isolate* isolate \ , v8::Persistent* object \ , type data) # define NAN_WEAK_CALLBACK_OBJECT (*object) # define NAN_WEAK_CALLBACK_DATA(type) ((type) data) # define NanScope() v8::HandleScope scope(nan_isolate) # define NanLocker() v8::Locker locker(nan_isolate) # define NanUnlocker() v8::Unlocker unlocker(nan_isolate) # define NanReturnValue(value) return args.GetReturnValue().Set(value) # define NanReturnUndefined() return # define NanReturnNull() return args.GetReturnValue().SetNull() # define NanReturnEmptyString() return args.GetReturnValue().SetEmptyString() # define NanAssignPersistent(type, handle, obj) handle.Reset(nan_isolate, obj) # define NanInitPersistent(type, name, obj) \ v8::Persistent name(nan_isolate, obj) # define NanObjectWrapHandle(obj) obj->handle() //TODO: remove <0.11.8 support when 0.12 is released #if NODE_VERSION_AT_LEAST(0, 11, 8) # define NanMakeWeak(handle, parameter, callback) \ handle.MakeWeak(parameter, callback) #else # define NanMakeWeak(handle, parameter, callback) \ handle.MakeWeak(nan_isolate, parameter, callback) #endif # define _NAN_ERROR(fun, errmsg) fun(v8::String::New(errmsg)) # define _NAN_THROW_ERROR(fun, errmsg) \ do { \ NanScope(); \ v8::ThrowException(_NAN_ERROR(fun, errmsg)); \ } while (0); template static NAN_INLINE(v8::Local NanNewLocal( v8::Handle val )) { //TODO: remove <0.11.9 support when 0.12 is released #if NODE_VERSION_AT_LEAST(0, 11, 9) return v8::Local::New(nan_isolate, val); #else return v8::Local::New(val); #endif } static NAN_INLINE(v8::Handle NanError(const char* errmsg)) { return _NAN_ERROR(v8::Exception::Error, errmsg); } static NAN_INLINE(void NanThrowError(const char* errmsg)) { _NAN_THROW_ERROR(v8::Exception::Error, errmsg); } static NAN_INLINE(void NanThrowError(v8::Handle error)) { NanScope(); v8::ThrowException(error); } static NAN_INLINE(v8::Handle NanError( const char *msg , const int errorNumber )) { v8::Local err = v8::Exception::Error(v8::String::New(msg)); v8::Local obj = err.As(); obj->Set(v8::String::New("code"), v8::Int32::New(errorNumber)); return err; } static NAN_INLINE(void NanThrowError( const char *msg , const int errorNumber )) { NanThrowError(NanError(msg, errorNumber)); } static NAN_INLINE(v8::Handle NanTypeError(const char* errmsg)) { return _NAN_ERROR(v8::Exception::TypeError, errmsg); } static NAN_INLINE(void NanThrowTypeError(const char* errmsg)) { _NAN_THROW_ERROR(v8::Exception::TypeError, errmsg); } static NAN_INLINE(v8::Handle NanRangeError(const char* errmsg)) { return _NAN_ERROR(v8::Exception::RangeError, errmsg); } static NAN_INLINE(void NanThrowRangeError(const char* errmsg)) { _NAN_THROW_ERROR(v8::Exception::RangeError, errmsg); } template static NAN_INLINE(void NanDisposePersistent( v8::Persistent &handle )) { //TODO: remove <0.11.8 support when 0.12 is released # if NODE_VERSION_AT_LEAST(0, 11, 8) handle.Reset(); # else handle.Dispose(nan_isolate); # endif handle.Clear(); } template static NAN_DEPRECATED(void NanDispose( v8::Persistent &handle )) { NanDisposePersistent(handle); } static NAN_INLINE(v8::Local NanNewBufferHandle ( char *data , size_t length , node::smalloc::FreeCallback callback , void *hint )) { return node::Buffer::New(data, length, callback, hint); } static NAN_INLINE(v8::Local NanNewBufferHandle ( char *data , uint32_t size )) { return node::Buffer::New(data, size); } static NAN_INLINE(v8::Local NanNewBufferHandle (uint32_t size)) { return node::Buffer::New(size); } static NAN_INLINE(v8::Local NanBufferUse( char* data , uint32_t size )) { return node::Buffer::Use(data, size); } template static NAN_INLINE(v8::Local NanPersistentToLocal( const v8::Persistent& persistent )) { return v8::Local::New(nan_isolate, persistent); } static NAN_INLINE(bool NanHasInstance( v8::Persistent& function_template , v8::Handle value )) { return NanPersistentToLocal(function_template)->HasInstance(value); } static NAN_INLINE(v8::Local NanNewContextHandle( v8::ExtensionConfiguration* extensions = NULL , v8::Handle tmpl = v8::Handle() , v8::Handle obj = v8::Handle() )) { return v8::Local::New( nan_isolate , v8::Context::New(nan_isolate, extensions, tmpl, obj) ); } #else // Node 0.8 and 0.10 # define _NAN_METHOD_ARGS_TYPE const v8::Arguments& # define _NAN_METHOD_ARGS _NAN_METHOD_ARGS_TYPE args # define _NAN_METHOD_RETURN_TYPE v8::Handle # define _NAN_GETTER_ARGS_TYPE const v8::AccessorInfo & # define _NAN_GETTER_ARGS _NAN_GETTER_ARGS_TYPE args # define _NAN_GETTER_RETURN_TYPE v8::Handle # define _NAN_SETTER_ARGS_TYPE const v8::AccessorInfo & # define _NAN_SETTER_ARGS _NAN_SETTER_ARGS_TYPE args # define _NAN_SETTER_RETURN_TYPE void # define _NAN_PROPERTY_GETTER_ARGS_TYPE const v8::AccessorInfo& # define _NAN_PROPERTY_GETTER_ARGS _NAN_PROPERTY_GETTER_ARGS_TYPE args # define _NAN_PROPERTY_GETTER_RETURN_TYPE v8::Handle # define _NAN_PROPERTY_SETTER_ARGS_TYPE const v8::AccessorInfo& # define _NAN_PROPERTY_SETTER_ARGS _NAN_PROPERTY_SETTER_ARGS_TYPE args # define _NAN_PROPERTY_SETTER_RETURN_TYPE v8::Handle # define _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE const v8::AccessorInfo& # define _NAN_PROPERTY_ENUMERATOR_ARGS _NAN_PROPERTY_ENUMERATOR_ARGS_TYPE args # define _NAN_PROPERTY_ENUMERATOR_RETURN_TYPE v8::Handle # define _NAN_PROPERTY_DELETER_ARGS_TYPE const v8::AccessorInfo& # define _NAN_PROPERTY_DELETER_ARGS _NAN_PROPERTY_DELETER_ARGS_TYPE args # define _NAN_PROPERTY_DELETER_RETURN_TYPE v8::Handle # define _NAN_PROPERTY_QUERY_ARGS_TYPE const v8::AccessorInfo& # define _NAN_PROPERTY_QUERY_ARGS _NAN_PROPERTY_QUERY_ARGS_TYPE args # define _NAN_PROPERTY_QUERY_RETURN_TYPE v8::Handle # define _NAN_INDEX_GETTER_ARGS_TYPE const v8::AccessorInfo& # define _NAN_INDEX_GETTER_ARGS _NAN_INDEX_GETTER_ARGS_TYPE args # define _NAN_INDEX_GETTER_RETURN_TYPE v8::Handle # define _NAN_INDEX_SETTER_ARGS_TYPE const v8::AccessorInfo& # define _NAN_INDEX_SETTER_ARGS _NAN_INDEX_SETTER_ARGS_TYPE args # define _NAN_INDEX_SETTER_RETURN_TYPE v8::Handle # define _NAN_INDEX_ENUMERATOR_ARGS_TYPE const v8::AccessorInfo& # define _NAN_INDEX_ENUMERATOR_ARGS _NAN_INDEX_ENUMERATOR_ARGS_TYPE args # define _NAN_INDEX_ENUMERATOR_RETURN_TYPE v8::Handle # define _NAN_INDEX_DELETER_ARGS_TYPE const v8::AccessorInfo& # define _NAN_INDEX_DELETER_ARGS _NAN_INDEX_DELETER_ARGS_TYPE args # define _NAN_INDEX_DELETER_RETURN_TYPE v8::Handle # define _NAN_INDEX_QUERY_ARGS_TYPE const v8::AccessorInfo& # define _NAN_INDEX_QUERY_ARGS _NAN_INDEX_QUERY_ARGS_TYPE args # define _NAN_INDEX_QUERY_RETURN_TYPE v8::Handle # define NanGetInternalFieldPointer(object, index) \ object->GetPointerFromInternalField(index) # define NanSetInternalFieldPointer(object, index, value) \ object->SetPointerInInternalField(index, value) # define NAN_WEAK_CALLBACK(type, name) \ void name( \ v8::Persistent object \ , void *data) # define NAN_WEAK_CALLBACK_OBJECT object # define NAN_WEAK_CALLBACK_DATA(type) ((type) data) # define NanScope() v8::HandleScope scope # define NanLocker() v8::Locker locker # define NanUnlocker() v8::Unlocker unlocker # define NanReturnValue(value) return scope.Close(value) # define NanReturnUndefined() return v8::Undefined() # define NanReturnNull() return v8::Null() # define NanReturnEmptyString() return v8::String::Empty() # define NanInitPersistent(type, name, obj) \ v8::Persistent name = v8::Persistent::New(obj) # define NanAssignPersistent(type, handle, obj) \ handle = v8::Persistent::New(obj) # define NanObjectWrapHandle(obj) obj->handle_ # define NanMakeWeak(handle, parameters, callback) \ handle.MakeWeak(parameters, callback) # define _NAN_ERROR(fun, errmsg) \ fun(v8::String::New(errmsg)) # define _NAN_THROW_ERROR(fun, errmsg) \ do { \ NanScope(); \ return v8::ThrowException(_NAN_ERROR(fun, errmsg)); \ } while (0); template static NAN_INLINE(v8::Local NanNewLocal( v8::Handle val )) { return v8::Local::New(val); } static NAN_INLINE(v8::Handle NanError(const char* errmsg)) { return _NAN_ERROR(v8::Exception::Error, errmsg); } static NAN_INLINE(v8::Handle NanThrowError(const char* errmsg)) { _NAN_THROW_ERROR(v8::Exception::Error, errmsg); } static NAN_INLINE(v8::Handle NanThrowError( v8::Handle error )) { NanScope(); return v8::ThrowException(error); } static NAN_INLINE(v8::Handle NanError( const char *msg , const int errorNumber )) { v8::Local err = v8::Exception::Error(v8::String::New(msg)); v8::Local obj = err.As(); obj->Set(v8::String::New("code"), v8::Int32::New(errorNumber)); return err; } static NAN_INLINE(v8::Handle NanThrowError( const char *msg , const int errorNumber )) { return NanThrowError(NanError(msg, errorNumber)); } static NAN_INLINE(v8::Handle NanTypeError(const char* errmsg)) { return _NAN_ERROR(v8::Exception::TypeError, errmsg); } static NAN_INLINE(v8::Handle NanThrowTypeError( const char* errmsg )) { _NAN_THROW_ERROR(v8::Exception::TypeError, errmsg); } static NAN_INLINE(v8::Handle NanRangeError( const char* errmsg )) { return _NAN_ERROR(v8::Exception::RangeError, errmsg); } static NAN_INLINE(v8::Handle NanThrowRangeError( const char* errmsg )) { _NAN_THROW_ERROR(v8::Exception::RangeError, errmsg); } template static NAN_INLINE(void NanDisposePersistent( v8::Persistent &handle )) { handle.Dispose(); handle.Clear(); } template static NAN_DEPRECATED(void NanDispose( v8::Persistent &handle )) { NanDisposePersistent(handle); } static NAN_INLINE(v8::Local NanNewBufferHandle ( char *data , size_t length , node::Buffer::free_callback callback , void *hint )) { return NanNewLocal( node::Buffer::New(data, length, callback, hint)->handle_); } static NAN_INLINE(v8::Local NanNewBufferHandle ( char *data , uint32_t size )) { return NanNewLocal(node::Buffer::New(data, size)->handle_); } static NAN_INLINE(v8::Local NanNewBufferHandle (uint32_t size)) { return NanNewLocal(node::Buffer::New(size)->handle_); } static NAN_INLINE(void FreeData(char *data, void *hint)) { delete[] data; } static NAN_INLINE(v8::Local NanBufferUse( char* data , uint32_t size )) { return NanNewLocal( node::Buffer::New(data, size, FreeData, NULL)->handle_); } template static NAN_INLINE(v8::Local NanPersistentToLocal( const v8::Persistent& persistent )) { return NanNewLocal(persistent); } static NAN_INLINE(bool NanHasInstance( v8::Persistent& function_template , v8::Handle value )) { return function_template->HasInstance(value); } static NAN_INLINE(v8::Local NanNewContextHandle( v8::ExtensionConfiguration* extensions = NULL , v8::Handle tmpl = v8::Handle() , v8::Handle obj = v8::Handle() )) { v8::Persistent ctx = v8::Context::New(extensions, tmpl, obj); v8::Local lctx = NanNewLocal(ctx); ctx.Dispose(); return lctx; } #endif // node version #define NAN_METHOD(name) _NAN_METHOD_RETURN_TYPE name(_NAN_METHOD_ARGS) #define NAN_GETTER(name) \ _NAN_GETTER_RETURN_TYPE name( \ v8::Local property \ , _NAN_GETTER_ARGS) #define NAN_SETTER(name) \ _NAN_SETTER_RETURN_TYPE name( \ v8::Local property \ , v8::Local value \ , _NAN_SETTER_ARGS) #define NAN_PROPERTY_GETTER(name) \ _NAN_PROPERTY_GETTER_RETURN_TYPE name( \ v8::Local property \ , _NAN_PROPERTY_GETTER_ARGS) #define NAN_PROPERTY_SETTER(name) \ _NAN_PROPERTY_SETTER_RETURN_TYPE name( \ v8::Local property \ , v8::Local value \ , _NAN_PROPERTY_SETTER_ARGS) #define NAN_PROPERTY_ENUMERATOR(name) \ _NAN_PROPERTY_ENUMERATOR_RETURN_TYPE name(_NAN_PROPERTY_ENUMERATOR_ARGS) #define NAN_PROPERTY_DELETER(name) \ _NAN_PROPERTY_DELETER_RETURN_TYPE name( \ v8::Local property \ , _NAN_PROPERTY_DELETER_ARGS) #define NAN_PROPERTY_QUERY(name) \ _NAN_PROPERTY_QUERY_RETURN_TYPE name( \ v8::Local property \ , _NAN_PROPERTY_QUERY_ARGS) # define NAN_INDEX_GETTER(name) \ _NAN_INDEX_GETTER_RETURN_TYPE name(uint32_t index, _NAN_INDEX_GETTER_ARGS) #define NAN_INDEX_SETTER(name) \ _NAN_INDEX_SETTER_RETURN_TYPE name( \ uint32_t index \ , v8::Local value \ , _NAN_INDEX_SETTER_ARGS) #define NAN_INDEX_ENUMERATOR(name) \ _NAN_INDEX_ENUMERATOR_RETURN_TYPE name(_NAN_INDEX_ENUMERATOR_ARGS) #define NAN_INDEX_DELETER(name) \ _NAN_INDEX_DELETER_RETURN_TYPE name( \ uint32_t index \ , _NAN_INDEX_DELETER_ARGS) #define NAN_INDEX_QUERY(name) \ _NAN_INDEX_QUERY_RETURN_TYPE name(uint32_t index, _NAN_INDEX_QUERY_ARGS) class NanCallback { public: NanCallback() { NanScope(); v8::Local obj = v8::Object::New(); NanAssignPersistent(v8::Object, handle, obj); } NanCallback(const v8::Handle &fn) { NanScope(); v8::Local obj = v8::Object::New(); NanAssignPersistent(v8::Object, handle, obj); SetFunction(fn); } ~NanCallback() { if (handle.IsEmpty()) return; handle.Dispose(); handle.Clear(); } NAN_INLINE(void SetFunction(const v8::Handle &fn)) { NanScope(); NanPersistentToLocal(handle)->Set(NanSymbol("callback"), fn); } NAN_INLINE(v8::Local GetFunction ()) { return NanPersistentToLocal(handle)->Get(NanSymbol("callback")) .As(); } void Call(int argc, v8::Handle argv[]) { NanScope(); #if NODE_VERSION_AT_LEAST(0, 8, 0) v8::Local callback = NanPersistentToLocal(handle)-> Get(NanSymbol("callback")).As(); node::MakeCallback( v8::Context::GetCurrent()->Global() , callback , argc , argv ); #else node::MakeCallback(handle, "callback", argc, argv); #endif } private: v8::Persistent handle; }; /* abstract */ class NanAsyncWorker { public: NanAsyncWorker (NanCallback *callback) : callback(callback) { request.data = this; errmsg = NULL; } virtual ~NanAsyncWorker () { NanScope(); if (!persistentHandle.IsEmpty()) NanDisposePersistent(persistentHandle); if (callback) delete callback; if (errmsg) delete errmsg; } virtual void WorkComplete () { NanScope(); if (errmsg == NULL) HandleOKCallback(); else HandleErrorCallback(); delete callback; callback = NULL; } void SavePersistent(const char *key, v8::Local &obj) { NanScope(); v8::Local handle = NanPersistentToLocal(persistentHandle); handle->Set(NanSymbol(key), obj); } v8::Local GetFromPersistent(const char *key) { NanScope(); v8::Local handle = NanPersistentToLocal(persistentHandle); return handle->Get(NanSymbol(key)).As(); } virtual void Execute () =0; uv_work_t request; protected: v8::Persistent persistentHandle; NanCallback *callback; const char *errmsg; virtual void HandleOKCallback () { NanScope(); callback->Call(0, NULL); }; virtual void HandleErrorCallback () { NanScope(); v8::Local argv[] = { v8::Exception::Error(v8::String::New(errmsg)) }; callback->Call(1, argv); } }; NAN_INLINE(void NanAsyncExecute (uv_work_t* req)) { NanAsyncWorker *worker = static_cast(req->data); worker->Execute(); } NAN_INLINE(void NanAsyncExecuteComplete (uv_work_t* req)) { NanAsyncWorker* worker = static_cast(req->data); worker->WorkComplete(); delete worker; } NAN_INLINE(void NanAsyncQueueWorker (NanAsyncWorker* worker)) { uv_queue_work( uv_default_loop() , &worker->request , NanAsyncExecute , (uv_after_work_cb)NanAsyncExecuteComplete ); } //// Base 64 //// #define _nan_base64_encoded_size(size) ((size + 2 - ((size + 2) % 3)) / 3 * 4) // Doesn't check for padding at the end. Can be 1-2 bytes over. static NAN_INLINE(size_t _nan_base64_decoded_size_fast(size_t size)) { size_t remainder = size % 4; size = (size / 4) * 3; if (remainder) { if (size == 0 && remainder == 1) { // special case: 1-byte input cannot be decoded size = 0; } else { // non-padded input, add 1 or 2 extra bytes size += 1 + (remainder == 3); } } return size; } template static NAN_INLINE(size_t _nan_base64_decoded_size( const TypeName* src , size_t size )) { if (size == 0) return 0; if (src[size - 1] == '=') size--; if (size > 0 && src[size - 1] == '=') size--; return _nan_base64_decoded_size_fast(size); } // supports regular and URL-safe base64 static const int _nan_unbase64_table[] = { -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -2, -1, -1, -2, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -2, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 62, -1, 62, -1, 63 , 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, -1, -1, -1, -1, -1, -1 , -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 , 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, -1, -1, -1, -1, 63 , -1, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40 , 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 , -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1 }; #define _nan_unbase64(x) _nan_unbase64_table[(uint8_t)(x)] template static size_t _nan_base64_decode( char* buf , size_t len , const TypeName* src , const size_t srcLen ) { char* dst = buf; char* dstEnd = buf + len; const TypeName* srcEnd = src + srcLen; while (src < srcEnd && dst < dstEnd) { int remaining = srcEnd - src; char a, b, c, d; while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--; if (remaining == 0 || *src == '=') break; a = _nan_unbase64(*src++); while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--; if (remaining <= 1 || *src == '=') break; b = _nan_unbase64(*src++); *dst++ = (a << 2) | ((b & 0x30) >> 4); if (dst == dstEnd) break; while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--; if (remaining <= 2 || *src == '=') break; c = _nan_unbase64(*src++); *dst++ = ((b & 0x0F) << 4) | ((c & 0x3C) >> 2); if (dst == dstEnd) break; while (_nan_unbase64(*src) < 0 && src < srcEnd) src++, remaining--; if (remaining <= 3 || *src == '=') break; d = _nan_unbase64(*src++); *dst++ = ((c & 0x03) << 6) | (d & 0x3F); } return dst - buf; } //// HEX //// template unsigned _nan_hex2bin(TypeName c) { if (c >= '0' && c <= '9') return c - '0'; if (c >= 'A' && c <= 'F') return 10 + (c - 'A'); if (c >= 'a' && c <= 'f') return 10 + (c - 'a'); return static_cast(-1); } template static size_t _nan_hex_decode( char* buf , size_t len , const TypeName* src , const size_t srcLen ) { size_t i; for (i = 0; i < len && i * 2 + 1 < srcLen; ++i) { unsigned a = _nan_hex2bin(src[i * 2 + 0]); unsigned b = _nan_hex2bin(src[i * 2 + 1]); if (!~a || !~b) return i; buf[i] = a * 16 + b; } return i; } static bool _NanGetExternalParts( v8::Handle val , const char** data , size_t* len ) { if (node::Buffer::HasInstance(val)) { *data = node::Buffer::Data(val.As()); *len = node::Buffer::Length(val.As()); return true; } assert(val->IsString()); v8::Local str = NanNewLocal(val.As()); if (str->IsExternalAscii()) { const v8::String::ExternalAsciiStringResource* ext; ext = str->GetExternalAsciiStringResource(); *data = ext->data(); *len = ext->length(); return true; } else if (str->IsExternal()) { const v8::String::ExternalStringResource* ext; ext = str->GetExternalStringResource(); *data = reinterpret_cast(ext->data()); *len = ext->length(); return true; } return false; } namespace Nan { enum Encoding {ASCII, UTF8, BASE64, UCS2, BINARY, HEX, BUFFER}; } static NAN_INLINE(void* NanRawString( v8::Handle from , enum Nan::Encoding encoding , size_t *datalen , void *buf , size_t buflen , int flags )) { NanScope(); size_t sz_; size_t term_len = !(flags & v8::String::NO_NULL_TERMINATION); char *data = NULL; size_t len; bool is_extern = _NanGetExternalParts( from , const_cast(&data) , &len); if (is_extern && !term_len) { NanSetPointerSafe(datalen, len); return data; } v8::Local toStr = from->ToString(); char *to = (char*)buf; switch(encoding) { case Nan::ASCII: #if NODE_MODULE_VERSION < 0x0C sz_ = toStr->Length(); if (to == NULL) { to = new char[sz_ + term_len]; } else { assert(buflen >= sz_ + term_len && "too small buffer"); } NanSetPointerSafe( datalen , toStr->WriteAscii(to, 0, sz_ + term_len, flags)); return to; #endif case Nan::BINARY: case Nan::BUFFER: sz_ = toStr->Length(); if (to == NULL) { to = new char[sz_ + term_len]; } else { assert(buflen >= sz_ + term_len && "too small buffer"); } #if NODE_MODULE_VERSION < 0x0C // TODO(isaacs): THIS IS AWFUL!!! // AGREE(kkoopa) { uint16_t* twobytebuf = new uint16_t[sz_ + term_len]; size_t len = toStr->Write(twobytebuf, 0, sz_ + term_len, flags); for (size_t i = 0; i < sz_ + term_len && i < len + term_len; i++) { unsigned char *b = reinterpret_cast(&twobytebuf[i]); to[i] = *b; } NanSetPointerSafe(datalen, len); delete[] twobytebuf; return to; } #else NanSetPointerSafe( datalen, toStr->WriteOneByte( reinterpret_cast(to) , 0 , sz_ + term_len , flags)); return to; #endif case Nan::UTF8: sz_ = toStr->Utf8Length(); if (to == NULL) { to = new char[sz_ + term_len]; } else { assert(buflen >= sz_ + term_len && "too small buffer"); } NanSetPointerSafe( datalen , toStr->WriteUtf8(to, sz_ + term_len, NULL, flags) - term_len); return to; case Nan::BASE64: { v8::String::Value value(toStr); sz_ = _nan_base64_decoded_size(*value, value.length()); if (to == NULL) { to = new char[sz_ + term_len]; } else { assert(buflen >= sz_ + term_len); } NanSetPointerSafe( datalen , _nan_base64_decode(to, sz_, *value, value.length())); if (term_len) { to[sz_] = '\0'; } return to; } case Nan::UCS2: { sz_ = toStr->Length(); if (to == NULL) { to = new char[(sz_ + term_len) * 2]; } else { assert(buflen >= (sz_ + term_len) * 2 && "too small buffer"); } int bc = 2 * toStr->Write( reinterpret_cast(to) , 0 , sz_ + term_len , flags); NanSetPointerSafe(datalen, bc); return to; } case Nan::HEX: { v8::String::Value value(toStr); sz_ = value.length(); assert(!(sz_ & 1) && "bad hex data"); if (to == NULL) { to = new char[sz_ / 2 + term_len]; } else { assert(buflen >= sz_ / 2 + term_len && "too small buffer"); } NanSetPointerSafe( datalen , _nan_hex_decode(to, sz_ / 2, *value, value.length())); } if (term_len) { to[sz_ / 2] = '\0'; } return to; default: assert(0 && "unknown encoding"); } return to; } static NAN_INLINE(char* NanFromV8String( v8::Handle from , enum Nan::Encoding encoding = Nan::UTF8 , size_t *datalen = NULL , char *buf = NULL , size_t buflen = 0 , int flags = v8::String::NO_NULL_TERMINATION | v8::String::HINT_MANY_WRITES_EXPECTED )) { return (char *) NanRawString(from, encoding, datalen, buf, buflen, flags); } static NAN_INLINE(char* NanCString( v8::Handle from , size_t *datalen , char *buf = NULL , size_t buflen = 0 , int flags = v8::String::NO_OPTIONS )) { return (char *) NanRawString(from, Nan::UTF8, datalen, buf, buflen, flags); } #endif