nan.h 84 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810
  1. /*********************************************************************
  2. * NAN - Native Abstractions for Node.js
  3. *
  4. * Copyright (c) 2018 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>
  11. * - David Siegel <https://github.com/agnat>
  12. * - Michael Ira Krufky <https://github.com/mkrufky>
  13. *
  14. * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
  15. *
  16. * Version 2.12.0: current Node 11.4.0, Node 12: 0.12.18, Node 10: 0.10.48, iojs: 3.3.1
  17. *
  18. * See https://github.com/nodejs/nan for the latest update to this file
  19. **********************************************************************************/
  20. #ifndef NAN_H_
  21. #define NAN_H_
  22. #include <node_version.h>
  23. #define NODE_0_10_MODULE_VERSION 11
  24. #define NODE_0_12_MODULE_VERSION 14
  25. #define ATOM_0_21_MODULE_VERSION 41
  26. #define IOJS_1_0_MODULE_VERSION 42
  27. #define IOJS_1_1_MODULE_VERSION 43
  28. #define IOJS_2_0_MODULE_VERSION 44
  29. #define IOJS_3_0_MODULE_VERSION 45
  30. #define NODE_4_0_MODULE_VERSION 46
  31. #define NODE_5_0_MODULE_VERSION 47
  32. #define NODE_6_0_MODULE_VERSION 48
  33. #define NODE_7_0_MODULE_VERSION 51
  34. #define NODE_8_0_MODULE_VERSION 57
  35. #define NODE_9_0_MODULE_VERSION 59
  36. #define NODE_10_0_MODULE_VERSION 64
  37. #define NODE_11_0_MODULE_VERSION 67
  38. #ifdef _MSC_VER
  39. # define NAN_HAS_CPLUSPLUS_11 (_MSC_VER >= 1800)
  40. #else
  41. # define NAN_HAS_CPLUSPLUS_11 (__cplusplus >= 201103L)
  42. #endif
  43. #if NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION && !NAN_HAS_CPLUSPLUS_11
  44. # error This version of node/NAN/v8 requires a C++11 compiler
  45. #endif
  46. #include <uv.h>
  47. #include <node.h>
  48. #include <node_buffer.h>
  49. #include <node_object_wrap.h>
  50. #include <algorithm>
  51. #include <cstring>
  52. #include <climits>
  53. #include <cstdlib>
  54. #include <utility>
  55. #if defined(_MSC_VER)
  56. # pragma warning( push )
  57. # pragma warning( disable : 4530 )
  58. # include <queue>
  59. # include <string>
  60. # include <vector>
  61. # pragma warning( pop )
  62. #else
  63. # include <queue>
  64. # include <string>
  65. # include <vector>
  66. #endif
  67. // uv helpers
  68. #ifdef UV_VERSION_MAJOR
  69. # ifndef UV_VERSION_PATCH
  70. # define UV_VERSION_PATCH 0
  71. # endif
  72. # define NAUV_UVVERSION ((UV_VERSION_MAJOR << 16) | \
  73. (UV_VERSION_MINOR << 8) | \
  74. (UV_VERSION_PATCH))
  75. #else
  76. # define NAUV_UVVERSION 0x000b00
  77. #endif
  78. #if NAUV_UVVERSION < 0x000b0b
  79. # ifdef WIN32
  80. # include <windows.h>
  81. # else
  82. # include <pthread.h>
  83. # endif
  84. #endif
  85. namespace Nan {
  86. #define NAN_CONCAT(a, b) NAN_CONCAT_HELPER(a, b)
  87. #define NAN_CONCAT_HELPER(a, b) a##b
  88. #define NAN_INLINE inline // TODO(bnoordhuis) Remove in v3.0.0.
  89. #if defined(__GNUC__) && \
  90. !(defined(V8_DISABLE_DEPRECATIONS) && V8_DISABLE_DEPRECATIONS)
  91. # define NAN_DEPRECATED __attribute__((deprecated))
  92. #elif defined(_MSC_VER) && \
  93. !(defined(V8_DISABLE_DEPRECATIONS) && V8_DISABLE_DEPRECATIONS)
  94. # define NAN_DEPRECATED __declspec(deprecated)
  95. #else
  96. # define NAN_DEPRECATED
  97. #endif
  98. #if NAN_HAS_CPLUSPLUS_11
  99. # define NAN_DISALLOW_ASSIGN(CLASS) void operator=(const CLASS&) = delete;
  100. # define NAN_DISALLOW_COPY(CLASS) CLASS(const CLASS&) = delete;
  101. # define NAN_DISALLOW_MOVE(CLASS) \
  102. CLASS(CLASS&&) = delete; /* NOLINT(build/c++11) */ \
  103. void operator=(CLASS&&) = delete;
  104. #else
  105. # define NAN_DISALLOW_ASSIGN(CLASS) void operator=(const CLASS&);
  106. # define NAN_DISALLOW_COPY(CLASS) CLASS(const CLASS&);
  107. # define NAN_DISALLOW_MOVE(CLASS)
  108. #endif
  109. #define NAN_DISALLOW_ASSIGN_COPY(CLASS) \
  110. NAN_DISALLOW_ASSIGN(CLASS) \
  111. NAN_DISALLOW_COPY(CLASS)
  112. #define NAN_DISALLOW_ASSIGN_MOVE(CLASS) \
  113. NAN_DISALLOW_ASSIGN(CLASS) \
  114. NAN_DISALLOW_MOVE(CLASS)
  115. #define NAN_DISALLOW_COPY_MOVE(CLASS) \
  116. NAN_DISALLOW_COPY(CLASS) \
  117. NAN_DISALLOW_MOVE(CLASS)
  118. #define NAN_DISALLOW_ASSIGN_COPY_MOVE(CLASS) \
  119. NAN_DISALLOW_ASSIGN(CLASS) \
  120. NAN_DISALLOW_COPY(CLASS) \
  121. NAN_DISALLOW_MOVE(CLASS)
  122. #define TYPE_CHECK(T, S) \
  123. while (false) { \
  124. *(static_cast<T *volatile *>(0)) = static_cast<S*>(0); \
  125. }
  126. //=== RegistrationFunction =====================================================
  127. #if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  128. typedef v8::Handle<v8::Object> ADDON_REGISTER_FUNCTION_ARGS_TYPE;
  129. #else
  130. typedef v8::Local<v8::Object> ADDON_REGISTER_FUNCTION_ARGS_TYPE;
  131. #endif
  132. #define NAN_MODULE_INIT(name) \
  133. void name(Nan::ADDON_REGISTER_FUNCTION_ARGS_TYPE target)
  134. #if NODE_MAJOR_VERSION >= 10 || \
  135. NODE_MAJOR_VERSION == 9 && NODE_MINOR_VERSION >= 3
  136. #define NAN_MODULE_WORKER_ENABLED(module_name, registration) \
  137. extern "C" NODE_MODULE_EXPORT void \
  138. NAN_CONCAT(node_register_module_v, NODE_MODULE_VERSION)( \
  139. v8::Local<v8::Object> exports, v8::Local<v8::Value> module, \
  140. v8::Local<v8::Context> context) \
  141. { \
  142. registration(exports); \
  143. }
  144. #else
  145. #define NAN_MODULE_WORKER_ENABLED(module_name, registration) \
  146. NODE_MODULE(module_name, registration)
  147. #endif
  148. //=== CallbackInfo =============================================================
  149. #include "nan_callbacks.h" // NOLINT(build/include)
  150. //==============================================================================
  151. #if (NODE_MODULE_VERSION < NODE_0_12_MODULE_VERSION)
  152. typedef v8::Script UnboundScript;
  153. typedef v8::Script BoundScript;
  154. #else
  155. typedef v8::UnboundScript UnboundScript;
  156. typedef v8::Script BoundScript;
  157. #endif
  158. #if (NODE_MODULE_VERSION < ATOM_0_21_MODULE_VERSION)
  159. typedef v8::String::ExternalAsciiStringResource
  160. ExternalOneByteStringResource;
  161. #else
  162. typedef v8::String::ExternalOneByteStringResource
  163. ExternalOneByteStringResource;
  164. #endif
  165. #if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
  166. template<typename T>
  167. class NonCopyablePersistentTraits :
  168. public v8::NonCopyablePersistentTraits<T> {};
  169. template<typename T>
  170. class CopyablePersistentTraits :
  171. public v8::CopyablePersistentTraits<T> {};
  172. template<typename T>
  173. class PersistentBase :
  174. public v8::PersistentBase<T> {};
  175. template<typename T, typename M = v8::NonCopyablePersistentTraits<T> >
  176. class Persistent;
  177. #else
  178. template<typename T> class NonCopyablePersistentTraits;
  179. template<typename T> class PersistentBase;
  180. template<typename T, typename P> class WeakCallbackData;
  181. template<typename T, typename M = NonCopyablePersistentTraits<T> >
  182. class Persistent;
  183. #endif // NODE_MODULE_VERSION
  184. #if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 || \
  185. (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
  186. # include "nan_maybe_43_inl.h" // NOLINT(build/include)
  187. #else
  188. # include "nan_maybe_pre_43_inl.h" // NOLINT(build/include)
  189. #endif
  190. #include "nan_converters.h" // NOLINT(build/include)
  191. #include "nan_new.h" // NOLINT(build/include)
  192. #if NAUV_UVVERSION < 0x000b17
  193. #define NAUV_WORK_CB(func) \
  194. void func(uv_async_t *async, int)
  195. #else
  196. #define NAUV_WORK_CB(func) \
  197. void func(uv_async_t *async)
  198. #endif
  199. #if NAUV_UVVERSION >= 0x000b0b
  200. typedef uv_key_t nauv_key_t;
  201. inline int nauv_key_create(nauv_key_t *key) {
  202. return uv_key_create(key);
  203. }
  204. inline void nauv_key_delete(nauv_key_t *key) {
  205. uv_key_delete(key);
  206. }
  207. inline void* nauv_key_get(nauv_key_t *key) {
  208. return uv_key_get(key);
  209. }
  210. inline void nauv_key_set(nauv_key_t *key, void *value) {
  211. uv_key_set(key, value);
  212. }
  213. #else
  214. /* Implement thread local storage for older versions of libuv.
  215. * This is essentially a backport of libuv commit 5d2434bf
  216. * written by Ben Noordhuis, adjusted for names and inline.
  217. */
  218. #ifndef WIN32
  219. typedef pthread_key_t nauv_key_t;
  220. inline int nauv_key_create(nauv_key_t* key) {
  221. return -pthread_key_create(key, NULL);
  222. }
  223. inline void nauv_key_delete(nauv_key_t* key) {
  224. if (pthread_key_delete(*key))
  225. abort();
  226. }
  227. inline void* nauv_key_get(nauv_key_t* key) {
  228. return pthread_getspecific(*key);
  229. }
  230. inline void nauv_key_set(nauv_key_t* key, void* value) {
  231. if (pthread_setspecific(*key, value))
  232. abort();
  233. }
  234. #else
  235. typedef struct {
  236. DWORD tls_index;
  237. } nauv_key_t;
  238. inline int nauv_key_create(nauv_key_t* key) {
  239. key->tls_index = TlsAlloc();
  240. if (key->tls_index == TLS_OUT_OF_INDEXES)
  241. return UV_ENOMEM;
  242. return 0;
  243. }
  244. inline void nauv_key_delete(nauv_key_t* key) {
  245. if (TlsFree(key->tls_index) == FALSE)
  246. abort();
  247. key->tls_index = TLS_OUT_OF_INDEXES;
  248. }
  249. inline void* nauv_key_get(nauv_key_t* key) {
  250. void* value = TlsGetValue(key->tls_index);
  251. if (value == NULL)
  252. if (GetLastError() != ERROR_SUCCESS)
  253. abort();
  254. return value;
  255. }
  256. inline void nauv_key_set(nauv_key_t* key, void* value) {
  257. if (TlsSetValue(key->tls_index, value) == FALSE)
  258. abort();
  259. }
  260. #endif
  261. #endif
  262. #if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  263. template<typename T>
  264. v8::Local<T> New(v8::Handle<T>);
  265. #endif
  266. #if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 || \
  267. (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
  268. typedef v8::WeakCallbackType WeakCallbackType;
  269. #else
  270. struct WeakCallbackType {
  271. enum E {kParameter, kInternalFields};
  272. E type;
  273. WeakCallbackType(E other) : type(other) {} // NOLINT(runtime/explicit)
  274. inline bool operator==(E other) { return other == this->type; }
  275. inline bool operator!=(E other) { return !operator==(other); }
  276. };
  277. #endif
  278. template<typename P> class WeakCallbackInfo;
  279. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  280. # include "nan_persistent_12_inl.h" // NOLINT(build/include)
  281. #else
  282. # include "nan_persistent_pre_12_inl.h" // NOLINT(build/include)
  283. #endif
  284. namespace imp {
  285. static const size_t kMaxLength = 0x3fffffff;
  286. // v8::String::REPLACE_INVALID_UTF8 was introduced
  287. // in node.js v0.10.29 and v0.8.27.
  288. #if NODE_MAJOR_VERSION > 0 || \
  289. NODE_MINOR_VERSION > 10 || \
  290. NODE_MINOR_VERSION == 10 && NODE_PATCH_VERSION >= 29 || \
  291. NODE_MINOR_VERSION == 8 && NODE_PATCH_VERSION >= 27
  292. static const unsigned kReplaceInvalidUtf8 = v8::String::REPLACE_INVALID_UTF8;
  293. #else
  294. static const unsigned kReplaceInvalidUtf8 = 0;
  295. #endif
  296. } // end of namespace imp
  297. //=== HandleScope ==============================================================
  298. class HandleScope {
  299. v8::HandleScope scope;
  300. public:
  301. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  302. inline HandleScope() : scope(v8::Isolate::GetCurrent()) {}
  303. inline static int NumberOfHandles() {
  304. return v8::HandleScope::NumberOfHandles(v8::Isolate::GetCurrent());
  305. }
  306. #else
  307. inline HandleScope() : scope() {}
  308. inline static int NumberOfHandles() {
  309. return v8::HandleScope::NumberOfHandles();
  310. }
  311. #endif
  312. private:
  313. // Make it hard to create heap-allocated or illegal handle scopes by
  314. // disallowing certain operations.
  315. HandleScope(const HandleScope &);
  316. void operator=(const HandleScope &);
  317. void *operator new(size_t size);
  318. void operator delete(void *, size_t) {
  319. abort();
  320. }
  321. };
  322. class EscapableHandleScope {
  323. public:
  324. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  325. inline EscapableHandleScope() : scope(v8::Isolate::GetCurrent()) {}
  326. inline static int NumberOfHandles() {
  327. return v8::EscapableHandleScope::NumberOfHandles(v8::Isolate::GetCurrent());
  328. }
  329. template<typename T>
  330. inline v8::Local<T> Escape(v8::Local<T> value) {
  331. return scope.Escape(value);
  332. }
  333. private:
  334. v8::EscapableHandleScope scope;
  335. #else
  336. inline EscapableHandleScope() : scope() {}
  337. inline static int NumberOfHandles() {
  338. return v8::HandleScope::NumberOfHandles();
  339. }
  340. template<typename T>
  341. inline v8::Local<T> Escape(v8::Local<T> value) {
  342. return scope.Close(value);
  343. }
  344. private:
  345. v8::HandleScope scope;
  346. #endif
  347. private:
  348. // Make it hard to create heap-allocated or illegal handle scopes by
  349. // disallowing certain operations.
  350. EscapableHandleScope(const EscapableHandleScope &);
  351. void operator=(const EscapableHandleScope &);
  352. void *operator new(size_t size);
  353. void operator delete(void *, size_t) {
  354. abort();
  355. }
  356. };
  357. //=== TryCatch =================================================================
  358. class TryCatch {
  359. v8::TryCatch try_catch_;
  360. friend void FatalException(const TryCatch&);
  361. public:
  362. #if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
  363. TryCatch() : try_catch_(v8::Isolate::GetCurrent()) {}
  364. #endif
  365. inline bool HasCaught() const { return try_catch_.HasCaught(); }
  366. inline bool CanContinue() const { return try_catch_.CanContinue(); }
  367. inline v8::Local<v8::Value> ReThrow() {
  368. #if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  369. return New(try_catch_.ReThrow());
  370. #else
  371. return try_catch_.ReThrow();
  372. #endif
  373. }
  374. inline v8::Local<v8::Value> Exception() const {
  375. return try_catch_.Exception();
  376. }
  377. #if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 || \
  378. (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
  379. inline v8::MaybeLocal<v8::Value> StackTrace() const {
  380. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  381. v8::EscapableHandleScope scope(isolate);
  382. return scope.Escape(try_catch_.StackTrace(isolate->GetCurrentContext())
  383. .FromMaybe(v8::Local<v8::Value>()));
  384. }
  385. #else
  386. inline MaybeLocal<v8::Value> StackTrace() const {
  387. return try_catch_.StackTrace();
  388. }
  389. #endif
  390. inline v8::Local<v8::Message> Message() const {
  391. return try_catch_.Message();
  392. }
  393. inline void Reset() { try_catch_.Reset(); }
  394. inline void SetVerbose(bool value) { try_catch_.SetVerbose(value); }
  395. inline void SetCaptureMessage(bool value) {
  396. try_catch_.SetCaptureMessage(value);
  397. }
  398. };
  399. v8::Local<v8::Value> MakeCallback(v8::Local<v8::Object> target,
  400. v8::Local<v8::Function> func,
  401. int argc,
  402. v8::Local<v8::Value>* argv);
  403. v8::Local<v8::Value> MakeCallback(v8::Local<v8::Object> target,
  404. v8::Local<v8::String> symbol,
  405. int argc,
  406. v8::Local<v8::Value>* argv);
  407. v8::Local<v8::Value> MakeCallback(v8::Local<v8::Object> target,
  408. const char* method,
  409. int argc,
  410. v8::Local<v8::Value>* argv);
  411. // === AsyncResource ===========================================================
  412. class AsyncResource {
  413. public:
  414. AsyncResource(
  415. v8::Local<v8::String> name
  416. , v8::Local<v8::Object> resource = New<v8::Object>()) {
  417. #if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  418. v8::Isolate* isolate = v8::Isolate::GetCurrent();
  419. if (resource.IsEmpty()) {
  420. resource = New<v8::Object>();
  421. }
  422. context = node::EmitAsyncInit(isolate, resource, name);
  423. #endif
  424. }
  425. AsyncResource(
  426. const char* name
  427. , v8::Local<v8::Object> resource = New<v8::Object>()) {
  428. #if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  429. v8::Isolate* isolate = v8::Isolate::GetCurrent();
  430. if (resource.IsEmpty()) {
  431. resource = New<v8::Object>();
  432. }
  433. v8::Local<v8::String> name_string =
  434. New<v8::String>(name).ToLocalChecked();
  435. context = node::EmitAsyncInit(isolate, resource, name_string);
  436. #endif
  437. }
  438. ~AsyncResource() {
  439. #if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  440. v8::Isolate* isolate = v8::Isolate::GetCurrent();
  441. node::EmitAsyncDestroy(isolate, context);
  442. #endif
  443. }
  444. inline MaybeLocal<v8::Value> runInAsyncScope(
  445. v8::Local<v8::Object> target
  446. , v8::Local<v8::Function> func
  447. , int argc
  448. , v8::Local<v8::Value>* argv) {
  449. #if NODE_MODULE_VERSION < NODE_9_0_MODULE_VERSION
  450. return MakeCallback(target, func, argc, argv);
  451. #else
  452. return node::MakeCallback(
  453. v8::Isolate::GetCurrent(), target, func, argc, argv, context);
  454. #endif
  455. }
  456. inline MaybeLocal<v8::Value> runInAsyncScope(
  457. v8::Local<v8::Object> target
  458. , v8::Local<v8::String> symbol
  459. , int argc
  460. , v8::Local<v8::Value>* argv) {
  461. #if NODE_MODULE_VERSION < NODE_9_0_MODULE_VERSION
  462. return MakeCallback(target, symbol, argc, argv);
  463. #else
  464. return node::MakeCallback(
  465. v8::Isolate::GetCurrent(), target, symbol, argc, argv, context);
  466. #endif
  467. }
  468. inline MaybeLocal<v8::Value> runInAsyncScope(
  469. v8::Local<v8::Object> target
  470. , const char* method
  471. , int argc
  472. , v8::Local<v8::Value>* argv) {
  473. #if NODE_MODULE_VERSION < NODE_9_0_MODULE_VERSION
  474. return MakeCallback(target, method, argc, argv);
  475. #else
  476. return node::MakeCallback(
  477. v8::Isolate::GetCurrent(), target, method, argc, argv, context);
  478. #endif
  479. }
  480. private:
  481. NAN_DISALLOW_ASSIGN_COPY_MOVE(AsyncResource)
  482. #if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  483. node::async_context context;
  484. #endif
  485. };
  486. inline uv_loop_t* GetCurrentEventLoop() {
  487. #if NODE_MAJOR_VERSION >= 10 || \
  488. NODE_MAJOR_VERSION == 9 && NODE_MINOR_VERSION >= 3 || \
  489. NODE_MAJOR_VERSION == 8 && NODE_MINOR_VERSION >= 10
  490. return node::GetCurrentEventLoop(v8::Isolate::GetCurrent());
  491. #else
  492. return uv_default_loop();
  493. #endif
  494. }
  495. //============ =================================================================
  496. /* node 0.12 */
  497. #if NODE_MODULE_VERSION >= NODE_0_12_MODULE_VERSION
  498. inline
  499. void SetCounterFunction(v8::CounterLookupCallback cb) {
  500. v8::Isolate::GetCurrent()->SetCounterFunction(cb);
  501. }
  502. inline
  503. void SetCreateHistogramFunction(v8::CreateHistogramCallback cb) {
  504. v8::Isolate::GetCurrent()->SetCreateHistogramFunction(cb);
  505. }
  506. inline
  507. void SetAddHistogramSampleFunction(v8::AddHistogramSampleCallback cb) {
  508. v8::Isolate::GetCurrent()->SetAddHistogramSampleFunction(cb);
  509. }
  510. #if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 || \
  511. (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
  512. inline bool IdleNotification(int idle_time_in_ms) {
  513. return v8::Isolate::GetCurrent()->IdleNotificationDeadline(
  514. idle_time_in_ms * 0.001);
  515. }
  516. # else
  517. inline bool IdleNotification(int idle_time_in_ms) {
  518. return v8::Isolate::GetCurrent()->IdleNotification(idle_time_in_ms);
  519. }
  520. #endif
  521. inline void LowMemoryNotification() {
  522. v8::Isolate::GetCurrent()->LowMemoryNotification();
  523. }
  524. inline void ContextDisposedNotification() {
  525. v8::Isolate::GetCurrent()->ContextDisposedNotification();
  526. }
  527. #else
  528. inline
  529. void SetCounterFunction(v8::CounterLookupCallback cb) {
  530. v8::V8::SetCounterFunction(cb);
  531. }
  532. inline
  533. void SetCreateHistogramFunction(v8::CreateHistogramCallback cb) {
  534. v8::V8::SetCreateHistogramFunction(cb);
  535. }
  536. inline
  537. void SetAddHistogramSampleFunction(v8::AddHistogramSampleCallback cb) {
  538. v8::V8::SetAddHistogramSampleFunction(cb);
  539. }
  540. inline bool IdleNotification(int idle_time_in_ms) {
  541. return v8::V8::IdleNotification(idle_time_in_ms);
  542. }
  543. inline void LowMemoryNotification() {
  544. v8::V8::LowMemoryNotification();
  545. }
  546. inline void ContextDisposedNotification() {
  547. v8::V8::ContextDisposedNotification();
  548. }
  549. #endif
  550. #if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION) // Node 0.12
  551. inline v8::Local<v8::Primitive> Undefined() {
  552. # if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  553. EscapableHandleScope scope;
  554. return scope.Escape(New(v8::Undefined(v8::Isolate::GetCurrent())));
  555. # else
  556. return v8::Undefined(v8::Isolate::GetCurrent());
  557. # endif
  558. }
  559. inline v8::Local<v8::Primitive> Null() {
  560. # if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  561. EscapableHandleScope scope;
  562. return scope.Escape(New(v8::Null(v8::Isolate::GetCurrent())));
  563. # else
  564. return v8::Null(v8::Isolate::GetCurrent());
  565. # endif
  566. }
  567. inline v8::Local<v8::Boolean> True() {
  568. # if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  569. EscapableHandleScope scope;
  570. return scope.Escape(New(v8::True(v8::Isolate::GetCurrent())));
  571. # else
  572. return v8::True(v8::Isolate::GetCurrent());
  573. # endif
  574. }
  575. inline v8::Local<v8::Boolean> False() {
  576. # if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  577. EscapableHandleScope scope;
  578. return scope.Escape(New(v8::False(v8::Isolate::GetCurrent())));
  579. # else
  580. return v8::False(v8::Isolate::GetCurrent());
  581. # endif
  582. }
  583. inline v8::Local<v8::String> EmptyString() {
  584. return v8::String::Empty(v8::Isolate::GetCurrent());
  585. }
  586. inline int AdjustExternalMemory(int bc) {
  587. return static_cast<int>(
  588. v8::Isolate::GetCurrent()->AdjustAmountOfExternalAllocatedMemory(bc));
  589. }
  590. inline void SetTemplate(
  591. v8::Local<v8::Template> templ
  592. , const char *name
  593. , v8::Local<v8::Data> value) {
  594. templ->Set(v8::Isolate::GetCurrent(), name, value);
  595. }
  596. inline void SetTemplate(
  597. v8::Local<v8::Template> templ
  598. , v8::Local<v8::String> name
  599. , v8::Local<v8::Data> value
  600. , v8::PropertyAttribute attributes) {
  601. templ->Set(name, value, attributes);
  602. }
  603. inline v8::Local<v8::Context> GetCurrentContext() {
  604. return v8::Isolate::GetCurrent()->GetCurrentContext();
  605. }
  606. inline void* GetInternalFieldPointer(
  607. v8::Local<v8::Object> object
  608. , int index) {
  609. return object->GetAlignedPointerFromInternalField(index);
  610. }
  611. inline void SetInternalFieldPointer(
  612. v8::Local<v8::Object> object
  613. , int index
  614. , void* value) {
  615. object->SetAlignedPointerInInternalField(index, value);
  616. }
  617. # define NAN_GC_CALLBACK(name) \
  618. void name(v8::Isolate *isolate, v8::GCType type, v8::GCCallbackFlags flags)
  619. #if NODE_MODULE_VERSION <= NODE_4_0_MODULE_VERSION
  620. typedef v8::Isolate::GCEpilogueCallback GCEpilogueCallback;
  621. typedef v8::Isolate::GCPrologueCallback GCPrologueCallback;
  622. #else
  623. typedef v8::Isolate::GCCallback GCEpilogueCallback;
  624. typedef v8::Isolate::GCCallback GCPrologueCallback;
  625. #endif
  626. inline void AddGCEpilogueCallback(
  627. GCEpilogueCallback callback
  628. , v8::GCType gc_type_filter = v8::kGCTypeAll) {
  629. v8::Isolate::GetCurrent()->AddGCEpilogueCallback(callback, gc_type_filter);
  630. }
  631. inline void RemoveGCEpilogueCallback(
  632. GCEpilogueCallback callback) {
  633. v8::Isolate::GetCurrent()->RemoveGCEpilogueCallback(callback);
  634. }
  635. inline void AddGCPrologueCallback(
  636. GCPrologueCallback callback
  637. , v8::GCType gc_type_filter = v8::kGCTypeAll) {
  638. v8::Isolate::GetCurrent()->AddGCPrologueCallback(callback, gc_type_filter);
  639. }
  640. inline void RemoveGCPrologueCallback(
  641. GCPrologueCallback callback) {
  642. v8::Isolate::GetCurrent()->RemoveGCPrologueCallback(callback);
  643. }
  644. inline void GetHeapStatistics(
  645. v8::HeapStatistics *heap_statistics) {
  646. v8::Isolate::GetCurrent()->GetHeapStatistics(heap_statistics);
  647. }
  648. # define X(NAME) \
  649. inline v8::Local<v8::Value> NAME(const char *msg) { \
  650. EscapableHandleScope scope; \
  651. return scope.Escape(v8::Exception::NAME(New(msg).ToLocalChecked())); \
  652. } \
  653. \
  654. inline \
  655. v8::Local<v8::Value> NAME(v8::Local<v8::String> msg) { \
  656. return v8::Exception::NAME(msg); \
  657. } \
  658. \
  659. inline void Throw ## NAME(const char *msg) { \
  660. HandleScope scope; \
  661. v8::Isolate::GetCurrent()->ThrowException( \
  662. v8::Exception::NAME(New(msg).ToLocalChecked())); \
  663. } \
  664. \
  665. inline void Throw ## NAME(v8::Local<v8::String> msg) { \
  666. HandleScope scope; \
  667. v8::Isolate::GetCurrent()->ThrowException( \
  668. v8::Exception::NAME(msg)); \
  669. }
  670. X(Error)
  671. X(RangeError)
  672. X(ReferenceError)
  673. X(SyntaxError)
  674. X(TypeError)
  675. # undef X
  676. inline void ThrowError(v8::Local<v8::Value> error) {
  677. v8::Isolate::GetCurrent()->ThrowException(error);
  678. }
  679. inline MaybeLocal<v8::Object> NewBuffer(
  680. char *data
  681. , size_t length
  682. #if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
  683. , node::Buffer::FreeCallback callback
  684. #else
  685. , node::smalloc::FreeCallback callback
  686. #endif
  687. , void *hint
  688. ) {
  689. // arbitrary buffer lengths requires
  690. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  691. assert(length <= imp::kMaxLength && "too large buffer");
  692. #if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
  693. return node::Buffer::New(
  694. v8::Isolate::GetCurrent(), data, length, callback, hint);
  695. #else
  696. return node::Buffer::New(v8::Isolate::GetCurrent(), data, length, callback,
  697. hint);
  698. #endif
  699. }
  700. inline MaybeLocal<v8::Object> CopyBuffer(
  701. const char *data
  702. , uint32_t size
  703. ) {
  704. // arbitrary buffer lengths requires
  705. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  706. assert(size <= imp::kMaxLength && "too large buffer");
  707. #if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
  708. return node::Buffer::Copy(
  709. v8::Isolate::GetCurrent(), data, size);
  710. #else
  711. return node::Buffer::New(v8::Isolate::GetCurrent(), data, size);
  712. #endif
  713. }
  714. inline MaybeLocal<v8::Object> NewBuffer(uint32_t size) {
  715. // arbitrary buffer lengths requires
  716. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  717. assert(size <= imp::kMaxLength && "too large buffer");
  718. #if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
  719. return node::Buffer::New(
  720. v8::Isolate::GetCurrent(), size);
  721. #else
  722. return node::Buffer::New(v8::Isolate::GetCurrent(), size);
  723. #endif
  724. }
  725. inline MaybeLocal<v8::Object> NewBuffer(
  726. char* data
  727. , uint32_t size
  728. ) {
  729. // arbitrary buffer lengths requires
  730. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  731. assert(size <= imp::kMaxLength && "too large buffer");
  732. #if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
  733. return node::Buffer::New(v8::Isolate::GetCurrent(), data, size);
  734. #else
  735. return node::Buffer::Use(v8::Isolate::GetCurrent(), data, size);
  736. #endif
  737. }
  738. #if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 || \
  739. (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
  740. inline MaybeLocal<v8::String>
  741. NewOneByteString(const uint8_t * value, int length = -1) {
  742. return v8::String::NewFromOneByte(v8::Isolate::GetCurrent(), value,
  743. v8::NewStringType::kNormal, length);
  744. }
  745. inline MaybeLocal<BoundScript> CompileScript(
  746. v8::Local<v8::String> s
  747. , const v8::ScriptOrigin& origin
  748. ) {
  749. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  750. v8::EscapableHandleScope scope(isolate);
  751. v8::ScriptCompiler::Source source(s, origin);
  752. return scope.Escape(
  753. v8::ScriptCompiler::Compile(isolate->GetCurrentContext(), &source)
  754. .FromMaybe(v8::Local<BoundScript>()));
  755. }
  756. inline MaybeLocal<BoundScript> CompileScript(
  757. v8::Local<v8::String> s
  758. ) {
  759. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  760. v8::EscapableHandleScope scope(isolate);
  761. v8::ScriptCompiler::Source source(s);
  762. return scope.Escape(
  763. v8::ScriptCompiler::Compile(isolate->GetCurrentContext(), &source)
  764. .FromMaybe(v8::Local<BoundScript>()));
  765. }
  766. inline MaybeLocal<v8::Value> RunScript(
  767. v8::Local<UnboundScript> script
  768. ) {
  769. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  770. v8::EscapableHandleScope scope(isolate);
  771. return scope.Escape(script->BindToCurrentContext()
  772. ->Run(isolate->GetCurrentContext())
  773. .FromMaybe(v8::Local<v8::Value>()));
  774. }
  775. inline MaybeLocal<v8::Value> RunScript(
  776. v8::Local<BoundScript> script
  777. ) {
  778. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  779. v8::EscapableHandleScope scope(isolate);
  780. return scope.Escape(script->Run(isolate->GetCurrentContext())
  781. .FromMaybe(v8::Local<v8::Value>()));
  782. }
  783. #else
  784. inline MaybeLocal<v8::String>
  785. NewOneByteString(const uint8_t * value, int length = -1) {
  786. return v8::String::NewFromOneByte(v8::Isolate::GetCurrent(), value,
  787. v8::String::kNormalString, length);
  788. }
  789. inline MaybeLocal<BoundScript> CompileScript(
  790. v8::Local<v8::String> s
  791. , const v8::ScriptOrigin& origin
  792. ) {
  793. v8::ScriptCompiler::Source source(s, origin);
  794. return v8::ScriptCompiler::Compile(v8::Isolate::GetCurrent(), &source);
  795. }
  796. inline MaybeLocal<BoundScript> CompileScript(
  797. v8::Local<v8::String> s
  798. ) {
  799. v8::ScriptCompiler::Source source(s);
  800. return v8::ScriptCompiler::Compile(v8::Isolate::GetCurrent(), &source);
  801. }
  802. inline MaybeLocal<v8::Value> RunScript(
  803. v8::Local<UnboundScript> script
  804. ) {
  805. EscapableHandleScope scope;
  806. return scope.Escape(script->BindToCurrentContext()->Run());
  807. }
  808. inline MaybeLocal<v8::Value> RunScript(
  809. v8::Local<BoundScript> script
  810. ) {
  811. return script->Run();
  812. }
  813. #endif
  814. NAN_DEPRECATED inline v8::Local<v8::Value> MakeCallback(
  815. v8::Local<v8::Object> target
  816. , v8::Local<v8::Function> func
  817. , int argc
  818. , v8::Local<v8::Value>* argv) {
  819. #if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  820. EscapableHandleScope scope;
  821. return scope.Escape(New(node::MakeCallback(
  822. v8::Isolate::GetCurrent(), target, func, argc, argv)));
  823. #else
  824. # if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  825. AsyncResource res("nan:makeCallback");
  826. return res.runInAsyncScope(target, func, argc, argv)
  827. .FromMaybe(v8::Local<v8::Value>());
  828. # else
  829. return node::MakeCallback(
  830. v8::Isolate::GetCurrent(), target, func, argc, argv);
  831. # endif // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  832. #endif // NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  833. }
  834. NAN_DEPRECATED inline v8::Local<v8::Value> MakeCallback(
  835. v8::Local<v8::Object> target
  836. , v8::Local<v8::String> symbol
  837. , int argc
  838. , v8::Local<v8::Value>* argv) {
  839. #if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  840. EscapableHandleScope scope;
  841. return scope.Escape(New(node::MakeCallback(
  842. v8::Isolate::GetCurrent(), target, symbol, argc, argv)));
  843. #else
  844. # if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  845. AsyncResource res("nan:makeCallback");
  846. return res.runInAsyncScope(target, symbol, argc, argv)
  847. .FromMaybe(v8::Local<v8::Value>());
  848. # else
  849. return node::MakeCallback(
  850. v8::Isolate::GetCurrent(), target, symbol, argc, argv);
  851. # endif // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  852. #endif // NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  853. }
  854. NAN_DEPRECATED inline v8::Local<v8::Value> MakeCallback(
  855. v8::Local<v8::Object> target
  856. , const char* method
  857. , int argc
  858. , v8::Local<v8::Value>* argv) {
  859. #if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  860. EscapableHandleScope scope;
  861. return scope.Escape(New(node::MakeCallback(
  862. v8::Isolate::GetCurrent(), target, method, argc, argv)));
  863. #else
  864. # if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  865. AsyncResource res("nan:makeCallback");
  866. return res.runInAsyncScope(target, method, argc, argv)
  867. .FromMaybe(v8::Local<v8::Value>());
  868. # else
  869. return node::MakeCallback(
  870. v8::Isolate::GetCurrent(), target, method, argc, argv);
  871. # endif // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  872. #endif // NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  873. }
  874. inline void FatalException(const TryCatch& try_catch) {
  875. node::FatalException(v8::Isolate::GetCurrent(), try_catch.try_catch_);
  876. }
  877. inline v8::Local<v8::Value> ErrnoException(
  878. int errorno
  879. , const char* syscall = NULL
  880. , const char* message = NULL
  881. , const char* path = NULL) {
  882. return node::ErrnoException(v8::Isolate::GetCurrent(), errorno, syscall,
  883. message, path);
  884. }
  885. NAN_DEPRECATED inline v8::Local<v8::Value> NanErrnoException(
  886. int errorno
  887. , const char* syscall = NULL
  888. , const char* message = NULL
  889. , const char* path = NULL) {
  890. return ErrnoException(errorno, syscall, message, path);
  891. }
  892. template<typename T>
  893. inline void SetIsolateData(
  894. v8::Isolate *isolate
  895. , T *data
  896. ) {
  897. isolate->SetData(0, data);
  898. }
  899. template<typename T>
  900. inline T *GetIsolateData(
  901. v8::Isolate *isolate
  902. ) {
  903. return static_cast<T*>(isolate->GetData(0));
  904. }
  905. class Utf8String {
  906. public:
  907. inline explicit Utf8String(v8::Local<v8::Value> from) :
  908. length_(0), str_(str_st_) {
  909. HandleScope scope;
  910. if (!from.IsEmpty()) {
  911. #if NODE_MAJOR_VERSION >= 10
  912. v8::Local<v8::Context> context = GetCurrentContext();
  913. v8::Local<v8::String> string =
  914. from->ToString(context).FromMaybe(v8::Local<v8::String>());
  915. #else
  916. v8::Local<v8::String> string = from->ToString();
  917. #endif
  918. if (!string.IsEmpty()) {
  919. size_t len = 3 * string->Length() + 1;
  920. assert(len <= INT_MAX);
  921. if (len > sizeof (str_st_)) {
  922. str_ = static_cast<char*>(malloc(len));
  923. assert(str_ != 0);
  924. }
  925. const int flags =
  926. v8::String::NO_NULL_TERMINATION | imp::kReplaceInvalidUtf8;
  927. #if NODE_MAJOR_VERSION >= 10
  928. length_ = string->WriteUtf8(v8::Isolate::GetCurrent(), str_, static_cast<int>(len), 0, flags);
  929. #else
  930. length_ = string->WriteUtf8(str_, static_cast<int>(len), 0, flags);
  931. #endif
  932. str_[length_] = '\0';
  933. }
  934. }
  935. }
  936. inline int length() const {
  937. return length_;
  938. }
  939. inline char* operator*() { return str_; }
  940. inline const char* operator*() const { return str_; }
  941. inline ~Utf8String() {
  942. if (str_ != str_st_) {
  943. free(str_);
  944. }
  945. }
  946. private:
  947. NAN_DISALLOW_ASSIGN_COPY_MOVE(Utf8String)
  948. int length_;
  949. char *str_;
  950. char str_st_[1024];
  951. };
  952. #else // Node 0.8 and 0.10
  953. inline v8::Local<v8::Primitive> Undefined() {
  954. EscapableHandleScope scope;
  955. return scope.Escape(New(v8::Undefined()));
  956. }
  957. inline v8::Local<v8::Primitive> Null() {
  958. EscapableHandleScope scope;
  959. return scope.Escape(New(v8::Null()));
  960. }
  961. inline v8::Local<v8::Boolean> True() {
  962. EscapableHandleScope scope;
  963. return scope.Escape(New(v8::True()));
  964. }
  965. inline v8::Local<v8::Boolean> False() {
  966. EscapableHandleScope scope;
  967. return scope.Escape(New(v8::False()));
  968. }
  969. inline v8::Local<v8::String> EmptyString() {
  970. return v8::String::Empty();
  971. }
  972. inline int AdjustExternalMemory(int bc) {
  973. return static_cast<int>(v8::V8::AdjustAmountOfExternalAllocatedMemory(bc));
  974. }
  975. inline void SetTemplate(
  976. v8::Local<v8::Template> templ
  977. , const char *name
  978. , v8::Local<v8::Data> value) {
  979. templ->Set(name, value);
  980. }
  981. inline void SetTemplate(
  982. v8::Local<v8::Template> templ
  983. , v8::Local<v8::String> name
  984. , v8::Local<v8::Data> value
  985. , v8::PropertyAttribute attributes) {
  986. templ->Set(name, value, attributes);
  987. }
  988. inline v8::Local<v8::Context> GetCurrentContext() {
  989. return v8::Context::GetCurrent();
  990. }
  991. inline void* GetInternalFieldPointer(
  992. v8::Local<v8::Object> object
  993. , int index) {
  994. return object->GetPointerFromInternalField(index);
  995. }
  996. inline void SetInternalFieldPointer(
  997. v8::Local<v8::Object> object
  998. , int index
  999. , void* value) {
  1000. object->SetPointerInInternalField(index, value);
  1001. }
  1002. # define NAN_GC_CALLBACK(name) \
  1003. void name(v8::GCType type, v8::GCCallbackFlags flags)
  1004. inline void AddGCEpilogueCallback(
  1005. v8::GCEpilogueCallback callback
  1006. , v8::GCType gc_type_filter = v8::kGCTypeAll) {
  1007. v8::V8::AddGCEpilogueCallback(callback, gc_type_filter);
  1008. }
  1009. inline void RemoveGCEpilogueCallback(
  1010. v8::GCEpilogueCallback callback) {
  1011. v8::V8::RemoveGCEpilogueCallback(callback);
  1012. }
  1013. inline void AddGCPrologueCallback(
  1014. v8::GCPrologueCallback callback
  1015. , v8::GCType gc_type_filter = v8::kGCTypeAll) {
  1016. v8::V8::AddGCPrologueCallback(callback, gc_type_filter);
  1017. }
  1018. inline void RemoveGCPrologueCallback(
  1019. v8::GCPrologueCallback callback) {
  1020. v8::V8::RemoveGCPrologueCallback(callback);
  1021. }
  1022. inline void GetHeapStatistics(
  1023. v8::HeapStatistics *heap_statistics) {
  1024. v8::V8::GetHeapStatistics(heap_statistics);
  1025. }
  1026. # define X(NAME) \
  1027. inline v8::Local<v8::Value> NAME(const char *msg) { \
  1028. EscapableHandleScope scope; \
  1029. return scope.Escape(v8::Exception::NAME(New(msg).ToLocalChecked())); \
  1030. } \
  1031. \
  1032. inline \
  1033. v8::Local<v8::Value> NAME(v8::Local<v8::String> msg) { \
  1034. return v8::Exception::NAME(msg); \
  1035. } \
  1036. \
  1037. inline void Throw ## NAME(const char *msg) { \
  1038. HandleScope scope; \
  1039. v8::ThrowException(v8::Exception::NAME(New(msg).ToLocalChecked())); \
  1040. } \
  1041. \
  1042. inline \
  1043. void Throw ## NAME(v8::Local<v8::String> errmsg) { \
  1044. HandleScope scope; \
  1045. v8::ThrowException(v8::Exception::NAME(errmsg)); \
  1046. }
  1047. X(Error)
  1048. X(RangeError)
  1049. X(ReferenceError)
  1050. X(SyntaxError)
  1051. X(TypeError)
  1052. # undef X
  1053. inline void ThrowError(v8::Local<v8::Value> error) {
  1054. v8::ThrowException(error);
  1055. }
  1056. inline MaybeLocal<v8::Object> NewBuffer(
  1057. char *data
  1058. , size_t length
  1059. , node::Buffer::free_callback callback
  1060. , void *hint
  1061. ) {
  1062. EscapableHandleScope scope;
  1063. // arbitrary buffer lengths requires
  1064. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  1065. assert(length <= imp::kMaxLength && "too large buffer");
  1066. return scope.Escape(
  1067. New(node::Buffer::New(data, length, callback, hint)->handle_));
  1068. }
  1069. inline MaybeLocal<v8::Object> CopyBuffer(
  1070. const char *data
  1071. , uint32_t size
  1072. ) {
  1073. EscapableHandleScope scope;
  1074. // arbitrary buffer lengths requires
  1075. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  1076. assert(size <= imp::kMaxLength && "too large buffer");
  1077. #if NODE_MODULE_VERSION >= NODE_0_10_MODULE_VERSION
  1078. return scope.Escape(New(node::Buffer::New(data, size)->handle_));
  1079. #else
  1080. return scope.Escape(
  1081. New(node::Buffer::New(const_cast<char *>(data), size)->handle_));
  1082. #endif
  1083. }
  1084. inline MaybeLocal<v8::Object> NewBuffer(uint32_t size) {
  1085. // arbitrary buffer lengths requires
  1086. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  1087. EscapableHandleScope scope;
  1088. assert(size <= imp::kMaxLength && "too large buffer");
  1089. return scope.Escape(New(node::Buffer::New(size)->handle_));
  1090. }
  1091. inline void FreeData(char *data, void *hint) {
  1092. (void) hint; // unused
  1093. delete[] data;
  1094. }
  1095. inline MaybeLocal<v8::Object> NewBuffer(
  1096. char* data
  1097. , uint32_t size
  1098. ) {
  1099. EscapableHandleScope scope;
  1100. // arbitrary buffer lengths requires
  1101. // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
  1102. assert(size <= imp::kMaxLength && "too large buffer");
  1103. return scope.Escape(
  1104. New(node::Buffer::New(data, size, FreeData, NULL)->handle_));
  1105. }
  1106. namespace imp {
  1107. inline void
  1108. widenString(std::vector<uint16_t> *ws, const uint8_t *s, int l) {
  1109. size_t len = static_cast<size_t>(l);
  1110. if (l < 0) {
  1111. len = strlen(reinterpret_cast<const char*>(s));
  1112. }
  1113. assert(len <= INT_MAX && "string too long");
  1114. ws->resize(len);
  1115. std::copy(s, s + len, ws->begin()); // NOLINT(build/include_what_you_use)
  1116. }
  1117. } // end of namespace imp
  1118. inline MaybeLocal<v8::String>
  1119. NewOneByteString(const uint8_t * value, int length = -1) {
  1120. std::vector<uint16_t> wideString; // NOLINT(build/include_what_you_use)
  1121. imp::widenString(&wideString, value, length);
  1122. return v8::String::New(wideString.data(),
  1123. static_cast<int>(wideString.size()));
  1124. }
  1125. inline MaybeLocal<BoundScript> CompileScript(
  1126. v8::Local<v8::String> s
  1127. , const v8::ScriptOrigin& origin
  1128. ) {
  1129. return v8::Script::Compile(s, const_cast<v8::ScriptOrigin *>(&origin));
  1130. }
  1131. inline MaybeLocal<BoundScript> CompileScript(
  1132. v8::Local<v8::String> s
  1133. ) {
  1134. return v8::Script::Compile(s);
  1135. }
  1136. inline
  1137. MaybeLocal<v8::Value> RunScript(v8::Local<v8::Script> script) {
  1138. return script->Run();
  1139. }
  1140. inline v8::Local<v8::Value> MakeCallback(
  1141. v8::Local<v8::Object> target
  1142. , v8::Local<v8::Function> func
  1143. , int argc
  1144. , v8::Local<v8::Value>* argv) {
  1145. v8::HandleScope scope;
  1146. return scope.Close(New(node::MakeCallback(target, func, argc, argv)));
  1147. }
  1148. inline v8::Local<v8::Value> MakeCallback(
  1149. v8::Local<v8::Object> target
  1150. , v8::Local<v8::String> symbol
  1151. , int argc
  1152. , v8::Local<v8::Value>* argv) {
  1153. v8::HandleScope scope;
  1154. return scope.Close(New(node::MakeCallback(target, symbol, argc, argv)));
  1155. }
  1156. inline v8::Local<v8::Value> MakeCallback(
  1157. v8::Local<v8::Object> target
  1158. , const char* method
  1159. , int argc
  1160. , v8::Local<v8::Value>* argv) {
  1161. v8::HandleScope scope;
  1162. return scope.Close(New(node::MakeCallback(target, method, argc, argv)));
  1163. }
  1164. inline void FatalException(const TryCatch& try_catch) {
  1165. node::FatalException(const_cast<v8::TryCatch &>(try_catch.try_catch_));
  1166. }
  1167. inline v8::Local<v8::Value> ErrnoException(
  1168. int errorno
  1169. , const char* syscall = NULL
  1170. , const char* message = NULL
  1171. , const char* path = NULL) {
  1172. return node::ErrnoException(errorno, syscall, message, path);
  1173. }
  1174. NAN_DEPRECATED inline v8::Local<v8::Value> NanErrnoException(
  1175. int errorno
  1176. , const char* syscall = NULL
  1177. , const char* message = NULL
  1178. , const char* path = NULL) {
  1179. return ErrnoException(errorno, syscall, message, path);
  1180. }
  1181. template<typename T>
  1182. inline void SetIsolateData(
  1183. v8::Isolate *isolate
  1184. , T *data
  1185. ) {
  1186. isolate->SetData(data);
  1187. }
  1188. template<typename T>
  1189. inline T *GetIsolateData(
  1190. v8::Isolate *isolate
  1191. ) {
  1192. return static_cast<T*>(isolate->GetData());
  1193. }
  1194. class Utf8String {
  1195. public:
  1196. inline explicit Utf8String(v8::Local<v8::Value> from) :
  1197. length_(0), str_(str_st_) {
  1198. v8::HandleScope scope;
  1199. if (!from.IsEmpty()) {
  1200. v8::Local<v8::String> string = from->ToString();
  1201. if (!string.IsEmpty()) {
  1202. size_t len = 3 * string->Length() + 1;
  1203. assert(len <= INT_MAX);
  1204. if (len > sizeof (str_st_)) {
  1205. str_ = static_cast<char*>(malloc(len));
  1206. assert(str_ != 0);
  1207. }
  1208. const int flags =
  1209. v8::String::NO_NULL_TERMINATION | imp::kReplaceInvalidUtf8;
  1210. length_ = string->WriteUtf8(str_, static_cast<int>(len), 0, flags);
  1211. str_[length_] = '\0';
  1212. }
  1213. }
  1214. }
  1215. inline int length() const {
  1216. return length_;
  1217. }
  1218. inline char* operator*() { return str_; }
  1219. inline const char* operator*() const { return str_; }
  1220. inline ~Utf8String() {
  1221. if (str_ != str_st_) {
  1222. free(str_);
  1223. }
  1224. }
  1225. private:
  1226. NAN_DISALLOW_ASSIGN_COPY_MOVE(Utf8String)
  1227. int length_;
  1228. char *str_;
  1229. char str_st_[1024];
  1230. };
  1231. #endif // NODE_MODULE_VERSION
  1232. typedef void (*FreeCallback)(char *data, void *hint);
  1233. typedef const FunctionCallbackInfo<v8::Value>& NAN_METHOD_ARGS_TYPE;
  1234. typedef void NAN_METHOD_RETURN_TYPE;
  1235. typedef const PropertyCallbackInfo<v8::Value>& NAN_GETTER_ARGS_TYPE;
  1236. typedef void NAN_GETTER_RETURN_TYPE;
  1237. typedef const PropertyCallbackInfo<void>& NAN_SETTER_ARGS_TYPE;
  1238. typedef void NAN_SETTER_RETURN_TYPE;
  1239. typedef const PropertyCallbackInfo<v8::Value>&
  1240. NAN_PROPERTY_GETTER_ARGS_TYPE;
  1241. typedef void NAN_PROPERTY_GETTER_RETURN_TYPE;
  1242. typedef const PropertyCallbackInfo<v8::Value>&
  1243. NAN_PROPERTY_SETTER_ARGS_TYPE;
  1244. typedef void NAN_PROPERTY_SETTER_RETURN_TYPE;
  1245. typedef const PropertyCallbackInfo<v8::Array>&
  1246. NAN_PROPERTY_ENUMERATOR_ARGS_TYPE;
  1247. typedef void NAN_PROPERTY_ENUMERATOR_RETURN_TYPE;
  1248. typedef const PropertyCallbackInfo<v8::Boolean>&
  1249. NAN_PROPERTY_DELETER_ARGS_TYPE;
  1250. typedef void NAN_PROPERTY_DELETER_RETURN_TYPE;
  1251. typedef const PropertyCallbackInfo<v8::Integer>&
  1252. NAN_PROPERTY_QUERY_ARGS_TYPE;
  1253. typedef void NAN_PROPERTY_QUERY_RETURN_TYPE;
  1254. typedef const PropertyCallbackInfo<v8::Value>& NAN_INDEX_GETTER_ARGS_TYPE;
  1255. typedef void NAN_INDEX_GETTER_RETURN_TYPE;
  1256. typedef const PropertyCallbackInfo<v8::Value>& NAN_INDEX_SETTER_ARGS_TYPE;
  1257. typedef void NAN_INDEX_SETTER_RETURN_TYPE;
  1258. typedef const PropertyCallbackInfo<v8::Array>&
  1259. NAN_INDEX_ENUMERATOR_ARGS_TYPE;
  1260. typedef void NAN_INDEX_ENUMERATOR_RETURN_TYPE;
  1261. typedef const PropertyCallbackInfo<v8::Boolean>&
  1262. NAN_INDEX_DELETER_ARGS_TYPE;
  1263. typedef void NAN_INDEX_DELETER_RETURN_TYPE;
  1264. typedef const PropertyCallbackInfo<v8::Integer>&
  1265. NAN_INDEX_QUERY_ARGS_TYPE;
  1266. typedef void NAN_INDEX_QUERY_RETURN_TYPE;
  1267. #define NAN_METHOD(name) \
  1268. Nan::NAN_METHOD_RETURN_TYPE name(Nan::NAN_METHOD_ARGS_TYPE info)
  1269. #define NAN_GETTER(name) \
  1270. Nan::NAN_GETTER_RETURN_TYPE name( \
  1271. v8::Local<v8::String> property \
  1272. , Nan::NAN_GETTER_ARGS_TYPE info)
  1273. #define NAN_SETTER(name) \
  1274. Nan::NAN_SETTER_RETURN_TYPE name( \
  1275. v8::Local<v8::String> property \
  1276. , v8::Local<v8::Value> value \
  1277. , Nan::NAN_SETTER_ARGS_TYPE info)
  1278. #define NAN_PROPERTY_GETTER(name) \
  1279. Nan::NAN_PROPERTY_GETTER_RETURN_TYPE name( \
  1280. v8::Local<v8::String> property \
  1281. , Nan::NAN_PROPERTY_GETTER_ARGS_TYPE info)
  1282. #define NAN_PROPERTY_SETTER(name) \
  1283. Nan::NAN_PROPERTY_SETTER_RETURN_TYPE name( \
  1284. v8::Local<v8::String> property \
  1285. , v8::Local<v8::Value> value \
  1286. , Nan::NAN_PROPERTY_SETTER_ARGS_TYPE info)
  1287. #define NAN_PROPERTY_ENUMERATOR(name) \
  1288. Nan::NAN_PROPERTY_ENUMERATOR_RETURN_TYPE name( \
  1289. Nan::NAN_PROPERTY_ENUMERATOR_ARGS_TYPE info)
  1290. #define NAN_PROPERTY_DELETER(name) \
  1291. Nan::NAN_PROPERTY_DELETER_RETURN_TYPE name( \
  1292. v8::Local<v8::String> property \
  1293. , Nan::NAN_PROPERTY_DELETER_ARGS_TYPE info)
  1294. #define NAN_PROPERTY_QUERY(name) \
  1295. Nan::NAN_PROPERTY_QUERY_RETURN_TYPE name( \
  1296. v8::Local<v8::String> property \
  1297. , Nan::NAN_PROPERTY_QUERY_ARGS_TYPE info)
  1298. # define NAN_INDEX_GETTER(name) \
  1299. Nan::NAN_INDEX_GETTER_RETURN_TYPE name( \
  1300. uint32_t index \
  1301. , Nan::NAN_INDEX_GETTER_ARGS_TYPE info)
  1302. #define NAN_INDEX_SETTER(name) \
  1303. Nan::NAN_INDEX_SETTER_RETURN_TYPE name( \
  1304. uint32_t index \
  1305. , v8::Local<v8::Value> value \
  1306. , Nan::NAN_INDEX_SETTER_ARGS_TYPE info)
  1307. #define NAN_INDEX_ENUMERATOR(name) \
  1308. Nan::NAN_INDEX_ENUMERATOR_RETURN_TYPE \
  1309. name(Nan::NAN_INDEX_ENUMERATOR_ARGS_TYPE info)
  1310. #define NAN_INDEX_DELETER(name) \
  1311. Nan::NAN_INDEX_DELETER_RETURN_TYPE name( \
  1312. uint32_t index \
  1313. , Nan::NAN_INDEX_DELETER_ARGS_TYPE info)
  1314. #define NAN_INDEX_QUERY(name) \
  1315. Nan::NAN_INDEX_QUERY_RETURN_TYPE name( \
  1316. uint32_t index \
  1317. , Nan::NAN_INDEX_QUERY_ARGS_TYPE info)
  1318. class Callback {
  1319. public:
  1320. Callback() {}
  1321. explicit Callback(const v8::Local<v8::Function> &fn) : handle_(fn) {}
  1322. ~Callback() {
  1323. handle_.Reset();
  1324. }
  1325. bool operator==(const Callback &other) const {
  1326. return handle_ == other.handle_;
  1327. }
  1328. bool operator!=(const Callback &other) const {
  1329. return !operator==(other);
  1330. }
  1331. inline
  1332. v8::Local<v8::Function> operator*() const { return GetFunction(); }
  1333. NAN_DEPRECATED inline v8::Local<v8::Value> operator()(
  1334. v8::Local<v8::Object> target
  1335. , int argc = 0
  1336. , v8::Local<v8::Value> argv[] = 0) const {
  1337. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1338. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  1339. # if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1340. AsyncResource async("nan:Callback:operator()");
  1341. return Call_(isolate, target, argc, argv, &async)
  1342. .FromMaybe(v8::Local<v8::Value>());
  1343. # else
  1344. return Call_(isolate, target, argc, argv);
  1345. # endif // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1346. #else
  1347. return Call_(target, argc, argv);
  1348. #endif // NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1349. }
  1350. NAN_DEPRECATED inline v8::Local<v8::Value> operator()(
  1351. int argc = 0
  1352. , v8::Local<v8::Value> argv[] = 0) const {
  1353. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1354. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  1355. v8::EscapableHandleScope scope(isolate);
  1356. # if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1357. AsyncResource async("nan:Callback:operator()");
  1358. return scope.Escape(Call_(isolate, isolate->GetCurrentContext()->Global(),
  1359. argc, argv, &async)
  1360. .FromMaybe(v8::Local<v8::Value>()));
  1361. # else
  1362. return scope.Escape(
  1363. Call_(isolate, isolate->GetCurrentContext()->Global(), argc, argv));
  1364. # endif // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1365. #else
  1366. v8::HandleScope scope;
  1367. return scope.Close(Call_(v8::Context::GetCurrent()->Global(), argc, argv));
  1368. #endif // NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1369. }
  1370. inline MaybeLocal<v8::Value> operator()(
  1371. AsyncResource* resource
  1372. , int argc = 0
  1373. , v8::Local<v8::Value> argv[] = 0) const {
  1374. return this->Call(argc, argv, resource);
  1375. }
  1376. inline MaybeLocal<v8::Value> operator()(
  1377. AsyncResource* resource
  1378. , v8::Local<v8::Object> target
  1379. , int argc = 0
  1380. , v8::Local<v8::Value> argv[] = 0) const {
  1381. return this->Call(target, argc, argv, resource);
  1382. }
  1383. // TODO(kkoopa): remove
  1384. inline void SetFunction(const v8::Local<v8::Function> &fn) {
  1385. Reset(fn);
  1386. }
  1387. inline void Reset(const v8::Local<v8::Function> &fn) {
  1388. handle_.Reset(fn);
  1389. }
  1390. inline void Reset() {
  1391. handle_.Reset();
  1392. }
  1393. inline v8::Local<v8::Function> GetFunction() const {
  1394. return New(handle_);
  1395. }
  1396. inline bool IsEmpty() const {
  1397. return handle_.IsEmpty();
  1398. }
  1399. // Deprecated: For async callbacks Use the versions that accept an
  1400. // AsyncResource. If this callback does not correspond to an async resource,
  1401. // that is, it is a synchronous function call on a non-empty JS stack, you
  1402. // should Nan::Call instead.
  1403. NAN_DEPRECATED inline v8::Local<v8::Value>
  1404. Call(v8::Local<v8::Object> target
  1405. , int argc
  1406. , v8::Local<v8::Value> argv[]) const {
  1407. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1408. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  1409. # if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1410. AsyncResource async("nan:Callback:Call");
  1411. return Call_(isolate, target, argc, argv, &async)
  1412. .FromMaybe(v8::Local<v8::Value>());
  1413. # else
  1414. return Call_(isolate, target, argc, argv);
  1415. # endif // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1416. #else
  1417. return Call_(target, argc, argv);
  1418. #endif
  1419. }
  1420. // Deprecated: For async callbacks Use the versions that accept an
  1421. // AsyncResource. If this callback does not correspond to an async resource,
  1422. // that is, it is a synchronous function call on a non-empty JS stack, you
  1423. // should Nan::Call instead.
  1424. NAN_DEPRECATED inline v8::Local<v8::Value>
  1425. Call(int argc, v8::Local<v8::Value> argv[]) const {
  1426. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1427. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  1428. v8::EscapableHandleScope scope(isolate);
  1429. # if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1430. AsyncResource async("nan:Callback:Call");
  1431. return scope.Escape(Call_(isolate, isolate->GetCurrentContext()->Global(),
  1432. argc, argv, &async)
  1433. .FromMaybe(v8::Local<v8::Value>()));
  1434. # else
  1435. return scope.Escape(
  1436. Call_(isolate, isolate->GetCurrentContext()->Global(), argc, argv));
  1437. # endif // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1438. #else
  1439. v8::HandleScope scope;
  1440. return scope.Close(Call_(v8::Context::GetCurrent()->Global(), argc, argv));
  1441. #endif
  1442. }
  1443. inline MaybeLocal<v8::Value>
  1444. Call(v8::Local<v8::Object> target
  1445. , int argc
  1446. , v8::Local<v8::Value> argv[]
  1447. , AsyncResource* resource) const {
  1448. #if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1449. v8::Isolate* isolate = v8::Isolate::GetCurrent();
  1450. return Call_(isolate, target, argc, argv, resource);
  1451. #elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1452. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  1453. return Call_(isolate, target, argc, argv);
  1454. #else
  1455. return Call_(target, argc, argv);
  1456. #endif
  1457. }
  1458. inline MaybeLocal<v8::Value>
  1459. Call(int argc, v8::Local<v8::Value> argv[], AsyncResource* resource) const {
  1460. #if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1461. v8::Isolate* isolate = v8::Isolate::GetCurrent();
  1462. return Call(isolate->GetCurrentContext()->Global(), argc, argv, resource);
  1463. #elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1464. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  1465. v8::EscapableHandleScope scope(isolate);
  1466. return scope.Escape(
  1467. Call_(isolate, isolate->GetCurrentContext()->Global(), argc, argv));
  1468. #else
  1469. v8::HandleScope scope;
  1470. return scope.Close(Call_(v8::Context::GetCurrent()->Global(), argc, argv));
  1471. #endif
  1472. }
  1473. private:
  1474. NAN_DISALLOW_ASSIGN_COPY_MOVE(Callback)
  1475. Persistent<v8::Function> handle_;
  1476. #if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
  1477. MaybeLocal<v8::Value> Call_(v8::Isolate *isolate
  1478. , v8::Local<v8::Object> target
  1479. , int argc
  1480. , v8::Local<v8::Value> argv[]
  1481. , AsyncResource* resource) const {
  1482. EscapableHandleScope scope;
  1483. v8::Local<v8::Function> func = New(handle_);
  1484. auto maybe = resource->runInAsyncScope(target, func, argc, argv);
  1485. v8::Local<v8::Value> local;
  1486. if (!maybe.ToLocal(&local)) return MaybeLocal<v8::Value>();
  1487. return scope.Escape(local);
  1488. }
  1489. #elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1490. v8::Local<v8::Value> Call_(v8::Isolate *isolate
  1491. , v8::Local<v8::Object> target
  1492. , int argc
  1493. , v8::Local<v8::Value> argv[]) const {
  1494. EscapableHandleScope scope;
  1495. v8::Local<v8::Function> callback = New(handle_);
  1496. # if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
  1497. return scope.Escape(New(node::MakeCallback(
  1498. isolate
  1499. , target
  1500. , callback
  1501. , argc
  1502. , argv
  1503. )));
  1504. # else
  1505. return scope.Escape(node::MakeCallback(
  1506. isolate
  1507. , target
  1508. , callback
  1509. , argc
  1510. , argv
  1511. ));
  1512. # endif
  1513. }
  1514. #else
  1515. v8::Local<v8::Value> Call_(v8::Local<v8::Object> target
  1516. , int argc
  1517. , v8::Local<v8::Value> argv[]) const {
  1518. EscapableHandleScope scope;
  1519. v8::Local<v8::Function> callback = New(handle_);
  1520. return scope.Escape(New(node::MakeCallback(
  1521. target
  1522. , callback
  1523. , argc
  1524. , argv
  1525. )));
  1526. }
  1527. #endif
  1528. };
  1529. inline MaybeLocal<v8::Value> Call(
  1530. const Nan::Callback& callback
  1531. , v8::Local<v8::Object> recv
  1532. , int argc
  1533. , v8::Local<v8::Value> argv[]) {
  1534. return Call(*callback, recv, argc, argv);
  1535. }
  1536. inline MaybeLocal<v8::Value> Call(
  1537. const Nan::Callback& callback
  1538. , int argc
  1539. , v8::Local<v8::Value> argv[]) {
  1540. #if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
  1541. v8::Isolate* isolate = v8::Isolate::GetCurrent();
  1542. v8::EscapableHandleScope scope(isolate);
  1543. return scope.Escape(
  1544. Call(*callback, isolate->GetCurrentContext()->Global(), argc, argv)
  1545. .FromMaybe(v8::Local<v8::Value>()));
  1546. #else
  1547. EscapableHandleScope scope;
  1548. return scope.Escape(
  1549. Call(*callback, v8::Context::GetCurrent()->Global(), argc, argv)
  1550. .FromMaybe(v8::Local<v8::Value>()));
  1551. #endif
  1552. }
  1553. inline MaybeLocal<v8::Value> Call(
  1554. v8::Local<v8::String> symbol
  1555. , v8::Local<v8::Object> recv
  1556. , int argc
  1557. , v8::Local<v8::Value> argv[]) {
  1558. EscapableHandleScope scope;
  1559. v8::Local<v8::Value> fn_v =
  1560. Get(recv, symbol).FromMaybe(v8::Local<v8::Value>());
  1561. if (fn_v.IsEmpty() || !fn_v->IsFunction()) return v8::Local<v8::Value>();
  1562. v8::Local<v8::Function> fn = fn_v.As<v8::Function>();
  1563. return scope.Escape(
  1564. Call(fn, recv, argc, argv).FromMaybe(v8::Local<v8::Value>()));
  1565. }
  1566. inline MaybeLocal<v8::Value> Call(
  1567. const char* method
  1568. , v8::Local<v8::Object> recv
  1569. , int argc
  1570. , v8::Local<v8::Value> argv[]) {
  1571. EscapableHandleScope scope;
  1572. v8::Local<v8::String> method_string =
  1573. New<v8::String>(method).ToLocalChecked();
  1574. return scope.Escape(
  1575. Call(method_string, recv, argc, argv).FromMaybe(v8::Local<v8::Value>()));
  1576. }
  1577. /* abstract */ class AsyncWorker {
  1578. public:
  1579. explicit AsyncWorker(Callback *callback_,
  1580. const char* resource_name = "nan:AsyncWorker")
  1581. : callback(callback_), errmsg_(NULL) {
  1582. request.data = this;
  1583. HandleScope scope;
  1584. v8::Local<v8::Object> obj = New<v8::Object>();
  1585. persistentHandle.Reset(obj);
  1586. async_resource = new AsyncResource(resource_name, obj);
  1587. }
  1588. virtual ~AsyncWorker() {
  1589. HandleScope scope;
  1590. if (!persistentHandle.IsEmpty())
  1591. persistentHandle.Reset();
  1592. delete callback;
  1593. delete[] errmsg_;
  1594. delete async_resource;
  1595. }
  1596. virtual void WorkComplete() {
  1597. HandleScope scope;
  1598. if (errmsg_ == NULL)
  1599. HandleOKCallback();
  1600. else
  1601. HandleErrorCallback();
  1602. delete callback;
  1603. callback = NULL;
  1604. }
  1605. inline void SaveToPersistent(
  1606. const char *key, const v8::Local<v8::Value> &value) {
  1607. HandleScope scope;
  1608. Set(New(persistentHandle), New(key).ToLocalChecked(), value).FromJust();
  1609. }
  1610. inline void SaveToPersistent(
  1611. const v8::Local<v8::String> &key, const v8::Local<v8::Value> &value) {
  1612. HandleScope scope;
  1613. Set(New(persistentHandle), key, value).FromJust();
  1614. }
  1615. inline void SaveToPersistent(
  1616. uint32_t index, const v8::Local<v8::Value> &value) {
  1617. HandleScope scope;
  1618. Set(New(persistentHandle), index, value).FromJust();
  1619. }
  1620. inline v8::Local<v8::Value> GetFromPersistent(const char *key) const {
  1621. EscapableHandleScope scope;
  1622. return scope.Escape(
  1623. Get(New(persistentHandle), New(key).ToLocalChecked())
  1624. .FromMaybe(v8::Local<v8::Value>()));
  1625. }
  1626. inline v8::Local<v8::Value>
  1627. GetFromPersistent(const v8::Local<v8::String> &key) const {
  1628. EscapableHandleScope scope;
  1629. return scope.Escape(
  1630. Get(New(persistentHandle), key)
  1631. .FromMaybe(v8::Local<v8::Value>()));
  1632. }
  1633. inline v8::Local<v8::Value> GetFromPersistent(uint32_t index) const {
  1634. EscapableHandleScope scope;
  1635. return scope.Escape(
  1636. Get(New(persistentHandle), index)
  1637. .FromMaybe(v8::Local<v8::Value>()));
  1638. }
  1639. virtual void Execute() = 0;
  1640. uv_work_t request;
  1641. virtual void Destroy() {
  1642. delete this;
  1643. }
  1644. protected:
  1645. Persistent<v8::Object> persistentHandle;
  1646. Callback *callback;
  1647. AsyncResource *async_resource;
  1648. virtual void HandleOKCallback() {
  1649. HandleScope scope;
  1650. callback->Call(0, NULL, async_resource);
  1651. }
  1652. virtual void HandleErrorCallback() {
  1653. HandleScope scope;
  1654. v8::Local<v8::Value> argv[] = {
  1655. v8::Exception::Error(New<v8::String>(ErrorMessage()).ToLocalChecked())
  1656. };
  1657. callback->Call(1, argv, async_resource);
  1658. }
  1659. void SetErrorMessage(const char *msg) {
  1660. delete[] errmsg_;
  1661. size_t size = strlen(msg) + 1;
  1662. errmsg_ = new char[size];
  1663. memcpy(errmsg_, msg, size);
  1664. }
  1665. const char* ErrorMessage() const {
  1666. return errmsg_;
  1667. }
  1668. private:
  1669. NAN_DISALLOW_ASSIGN_COPY_MOVE(AsyncWorker)
  1670. char *errmsg_;
  1671. };
  1672. /* abstract */ class AsyncBareProgressWorkerBase : public AsyncWorker {
  1673. public:
  1674. explicit AsyncBareProgressWorkerBase(
  1675. Callback *callback_,
  1676. const char* resource_name = "nan:AsyncBareProgressWorkerBase")
  1677. : AsyncWorker(callback_, resource_name) {
  1678. uv_async_init(
  1679. GetCurrentEventLoop()
  1680. , &async
  1681. , AsyncProgress_
  1682. );
  1683. async.data = this;
  1684. }
  1685. virtual ~AsyncBareProgressWorkerBase() {
  1686. }
  1687. virtual void WorkProgress() = 0;
  1688. virtual void Destroy() {
  1689. uv_close(reinterpret_cast<uv_handle_t*>(&async), AsyncClose_);
  1690. }
  1691. private:
  1692. inline static NAUV_WORK_CB(AsyncProgress_) {
  1693. AsyncBareProgressWorkerBase *worker =
  1694. static_cast<AsyncBareProgressWorkerBase*>(async->data);
  1695. worker->WorkProgress();
  1696. }
  1697. inline static void AsyncClose_(uv_handle_t* handle) {
  1698. AsyncBareProgressWorkerBase *worker =
  1699. static_cast<AsyncBareProgressWorkerBase*>(handle->data);
  1700. delete worker;
  1701. }
  1702. protected:
  1703. uv_async_t async;
  1704. };
  1705. template<class T>
  1706. /* abstract */
  1707. class AsyncBareProgressWorker : public AsyncBareProgressWorkerBase {
  1708. public:
  1709. explicit AsyncBareProgressWorker(
  1710. Callback *callback_,
  1711. const char* resource_name = "nan:AsyncBareProgressWorker")
  1712. : AsyncBareProgressWorkerBase(callback_, resource_name) {
  1713. uv_mutex_init(&async_lock);
  1714. }
  1715. virtual ~AsyncBareProgressWorker() {
  1716. uv_mutex_destroy(&async_lock);
  1717. }
  1718. class ExecutionProgress {
  1719. friend class AsyncBareProgressWorker;
  1720. public:
  1721. void Signal() const {
  1722. uv_mutex_lock(&that_->async_lock);
  1723. uv_async_send(&that_->async);
  1724. uv_mutex_unlock(&that_->async_lock);
  1725. }
  1726. void Send(const T* data, size_t count) const {
  1727. that_->SendProgress_(data, count);
  1728. }
  1729. private:
  1730. explicit ExecutionProgress(AsyncBareProgressWorker *that) : that_(that) {}
  1731. NAN_DISALLOW_ASSIGN_COPY_MOVE(ExecutionProgress)
  1732. AsyncBareProgressWorker* const that_;
  1733. };
  1734. virtual void Execute(const ExecutionProgress& progress) = 0;
  1735. virtual void HandleProgressCallback(const T *data, size_t size) = 0;
  1736. protected:
  1737. uv_mutex_t async_lock;
  1738. private:
  1739. void Execute() /*final override*/ {
  1740. ExecutionProgress progress(this);
  1741. Execute(progress);
  1742. }
  1743. virtual void SendProgress_(const T *data, size_t count) = 0;
  1744. };
  1745. template<class T>
  1746. /* abstract */
  1747. class AsyncProgressWorkerBase : public AsyncBareProgressWorker<T> {
  1748. public:
  1749. explicit AsyncProgressWorkerBase(
  1750. Callback *callback_,
  1751. const char* resource_name = "nan:AsyncProgressWorkerBase")
  1752. : AsyncBareProgressWorker<T>(callback_, resource_name), asyncdata_(NULL),
  1753. asyncsize_(0) {
  1754. }
  1755. virtual ~AsyncProgressWorkerBase() {
  1756. delete[] asyncdata_;
  1757. }
  1758. void WorkProgress() {
  1759. uv_mutex_lock(&this->async_lock);
  1760. T *data = asyncdata_;
  1761. size_t size = asyncsize_;
  1762. asyncdata_ = NULL;
  1763. asyncsize_ = 0;
  1764. uv_mutex_unlock(&this->async_lock);
  1765. // Don't send progress events after we've already completed.
  1766. if (this->callback) {
  1767. this->HandleProgressCallback(data, size);
  1768. }
  1769. delete[] data;
  1770. }
  1771. private:
  1772. void SendProgress_(const T *data, size_t count) {
  1773. T *new_data = new T[count];
  1774. {
  1775. T *it = new_data;
  1776. std::copy(data, data + count, it);
  1777. }
  1778. uv_mutex_lock(&this->async_lock);
  1779. T *old_data = asyncdata_;
  1780. asyncdata_ = new_data;
  1781. asyncsize_ = count;
  1782. uv_async_send(&this->async);
  1783. uv_mutex_unlock(&this->async_lock);
  1784. delete[] old_data;
  1785. }
  1786. T *asyncdata_;
  1787. size_t asyncsize_;
  1788. };
  1789. // This ensures compatibility to the previous un-templated AsyncProgressWorker
  1790. // class definition.
  1791. typedef AsyncProgressWorkerBase<char> AsyncProgressWorker;
  1792. template<class T>
  1793. /* abstract */
  1794. class AsyncBareProgressQueueWorker : public AsyncBareProgressWorkerBase {
  1795. public:
  1796. explicit AsyncBareProgressQueueWorker(
  1797. Callback *callback_,
  1798. const char* resource_name = "nan:AsyncBareProgressQueueWorker")
  1799. : AsyncBareProgressWorkerBase(callback_, resource_name) {
  1800. }
  1801. virtual ~AsyncBareProgressQueueWorker() {
  1802. }
  1803. class ExecutionProgress {
  1804. friend class AsyncBareProgressQueueWorker;
  1805. public:
  1806. void Send(const T* data, size_t count) const {
  1807. that_->SendProgress_(data, count);
  1808. }
  1809. private:
  1810. explicit ExecutionProgress(AsyncBareProgressQueueWorker *that)
  1811. : that_(that) {}
  1812. NAN_DISALLOW_ASSIGN_COPY_MOVE(ExecutionProgress)
  1813. AsyncBareProgressQueueWorker* const that_;
  1814. };
  1815. virtual void Execute(const ExecutionProgress& progress) = 0;
  1816. virtual void HandleProgressCallback(const T *data, size_t size) = 0;
  1817. private:
  1818. void Execute() /*final override*/ {
  1819. ExecutionProgress progress(this);
  1820. Execute(progress);
  1821. }
  1822. virtual void SendProgress_(const T *data, size_t count) = 0;
  1823. };
  1824. template<class T>
  1825. /* abstract */
  1826. class AsyncProgressQueueWorker : public AsyncBareProgressQueueWorker<T> {
  1827. public:
  1828. explicit AsyncProgressQueueWorker(
  1829. Callback *callback_,
  1830. const char* resource_name = "nan:AsyncProgressQueueWorker")
  1831. : AsyncBareProgressQueueWorker<T>(callback_) {
  1832. uv_mutex_init(&async_lock);
  1833. }
  1834. virtual ~AsyncProgressQueueWorker() {
  1835. uv_mutex_lock(&async_lock);
  1836. while (!asyncdata_.empty()) {
  1837. std::pair<T*, size_t> &datapair = asyncdata_.front();
  1838. T *data = datapair.first;
  1839. asyncdata_.pop();
  1840. delete[] data;
  1841. }
  1842. uv_mutex_unlock(&async_lock);
  1843. uv_mutex_destroy(&async_lock);
  1844. }
  1845. void WorkComplete() {
  1846. WorkProgress();
  1847. AsyncWorker::WorkComplete();
  1848. }
  1849. void WorkProgress() {
  1850. uv_mutex_lock(&async_lock);
  1851. while (!asyncdata_.empty()) {
  1852. std::pair<T*, size_t> &datapair = asyncdata_.front();
  1853. T *data = datapair.first;
  1854. size_t size = datapair.second;
  1855. asyncdata_.pop();
  1856. uv_mutex_unlock(&async_lock);
  1857. // Don't send progress events after we've already completed.
  1858. if (this->callback) {
  1859. this->HandleProgressCallback(data, size);
  1860. }
  1861. delete[] data;
  1862. uv_mutex_lock(&async_lock);
  1863. }
  1864. uv_mutex_unlock(&async_lock);
  1865. }
  1866. private:
  1867. void SendProgress_(const T *data, size_t count) {
  1868. T *new_data = new T[count];
  1869. {
  1870. T *it = new_data;
  1871. std::copy(data, data + count, it);
  1872. }
  1873. uv_mutex_lock(&async_lock);
  1874. asyncdata_.push(std::pair<T*, size_t>(new_data, count));
  1875. uv_mutex_unlock(&async_lock);
  1876. uv_async_send(&this->async);
  1877. }
  1878. uv_mutex_t async_lock;
  1879. std::queue<std::pair<T*, size_t> > asyncdata_;
  1880. };
  1881. inline void AsyncExecute (uv_work_t* req) {
  1882. AsyncWorker *worker = static_cast<AsyncWorker*>(req->data);
  1883. worker->Execute();
  1884. }
  1885. inline void AsyncExecuteComplete (uv_work_t* req) {
  1886. AsyncWorker* worker = static_cast<AsyncWorker*>(req->data);
  1887. worker->WorkComplete();
  1888. worker->Destroy();
  1889. }
  1890. inline void AsyncQueueWorker (AsyncWorker* worker) {
  1891. uv_queue_work(
  1892. GetCurrentEventLoop()
  1893. , &worker->request
  1894. , AsyncExecute
  1895. , reinterpret_cast<uv_after_work_cb>(AsyncExecuteComplete)
  1896. );
  1897. }
  1898. namespace imp {
  1899. inline
  1900. ExternalOneByteStringResource const*
  1901. GetExternalResource(v8::Local<v8::String> str) {
  1902. #if NODE_MODULE_VERSION < ATOM_0_21_MODULE_VERSION
  1903. return str->GetExternalAsciiStringResource();
  1904. #else
  1905. return str->GetExternalOneByteStringResource();
  1906. #endif
  1907. }
  1908. inline
  1909. bool
  1910. IsExternal(v8::Local<v8::String> str) {
  1911. #if NODE_MODULE_VERSION < ATOM_0_21_MODULE_VERSION
  1912. return str->IsExternalAscii();
  1913. #else
  1914. return str->IsExternalOneByte();
  1915. #endif
  1916. }
  1917. } // end of namespace imp
  1918. enum Encoding {ASCII, UTF8, BASE64, UCS2, BINARY, HEX, BUFFER};
  1919. #if NODE_MODULE_VERSION < NODE_0_10_MODULE_VERSION
  1920. # include "nan_string_bytes.h" // NOLINT(build/include)
  1921. #endif
  1922. inline v8::Local<v8::Value> Encode(
  1923. const void *buf, size_t len, enum Encoding encoding = BINARY) {
  1924. #if (NODE_MODULE_VERSION >= ATOM_0_21_MODULE_VERSION)
  1925. v8::Isolate* isolate = v8::Isolate::GetCurrent();
  1926. node::encoding node_enc = static_cast<node::encoding>(encoding);
  1927. if (encoding == UCS2) {
  1928. return node::Encode(
  1929. isolate
  1930. , reinterpret_cast<const uint16_t *>(buf)
  1931. , len / 2);
  1932. } else {
  1933. return node::Encode(
  1934. isolate
  1935. , reinterpret_cast<const char *>(buf)
  1936. , len
  1937. , node_enc);
  1938. }
  1939. #elif (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
  1940. return node::Encode(
  1941. v8::Isolate::GetCurrent()
  1942. , buf, len
  1943. , static_cast<node::encoding>(encoding));
  1944. #else
  1945. # if NODE_MODULE_VERSION >= NODE_0_10_MODULE_VERSION
  1946. return node::Encode(buf, len, static_cast<node::encoding>(encoding));
  1947. # else
  1948. return imp::Encode(reinterpret_cast<const char*>(buf), len, encoding);
  1949. # endif
  1950. #endif
  1951. }
  1952. inline ssize_t DecodeBytes(
  1953. v8::Local<v8::Value> val, enum Encoding encoding = BINARY) {
  1954. #if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
  1955. return node::DecodeBytes(
  1956. v8::Isolate::GetCurrent()
  1957. , val
  1958. , static_cast<node::encoding>(encoding));
  1959. #else
  1960. # if (NODE_MODULE_VERSION < NODE_0_10_MODULE_VERSION)
  1961. if (encoding == BUFFER) {
  1962. return node::DecodeBytes(val, node::BINARY);
  1963. }
  1964. # endif
  1965. return node::DecodeBytes(val, static_cast<node::encoding>(encoding));
  1966. #endif
  1967. }
  1968. inline ssize_t DecodeWrite(
  1969. char *buf
  1970. , size_t len
  1971. , v8::Local<v8::Value> val
  1972. , enum Encoding encoding = BINARY) {
  1973. #if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
  1974. return node::DecodeWrite(
  1975. v8::Isolate::GetCurrent()
  1976. , buf
  1977. , len
  1978. , val
  1979. , static_cast<node::encoding>(encoding));
  1980. #else
  1981. # if (NODE_MODULE_VERSION < NODE_0_10_MODULE_VERSION)
  1982. if (encoding == BUFFER) {
  1983. return node::DecodeWrite(buf, len, val, node::BINARY);
  1984. }
  1985. # endif
  1986. return node::DecodeWrite(
  1987. buf
  1988. , len
  1989. , val
  1990. , static_cast<node::encoding>(encoding));
  1991. #endif
  1992. }
  1993. inline void SetPrototypeTemplate(
  1994. v8::Local<v8::FunctionTemplate> templ
  1995. , const char *name
  1996. , v8::Local<v8::Data> value
  1997. ) {
  1998. HandleScope scope;
  1999. SetTemplate(templ->PrototypeTemplate(), name, value);
  2000. }
  2001. inline void SetPrototypeTemplate(
  2002. v8::Local<v8::FunctionTemplate> templ
  2003. , v8::Local<v8::String> name
  2004. , v8::Local<v8::Data> value
  2005. , v8::PropertyAttribute attributes
  2006. ) {
  2007. HandleScope scope;
  2008. SetTemplate(templ->PrototypeTemplate(), name, value, attributes);
  2009. }
  2010. inline void SetInstanceTemplate(
  2011. v8::Local<v8::FunctionTemplate> templ
  2012. , const char *name
  2013. , v8::Local<v8::Data> value
  2014. ) {
  2015. HandleScope scope;
  2016. SetTemplate(templ->InstanceTemplate(), name, value);
  2017. }
  2018. inline void SetInstanceTemplate(
  2019. v8::Local<v8::FunctionTemplate> templ
  2020. , v8::Local<v8::String> name
  2021. , v8::Local<v8::Data> value
  2022. , v8::PropertyAttribute attributes
  2023. ) {
  2024. HandleScope scope;
  2025. SetTemplate(templ->InstanceTemplate(), name, value, attributes);
  2026. }
  2027. namespace imp {
  2028. // Note(@agnat): Helper to distinguish different receiver types. The first
  2029. // version deals with receivers derived from v8::Template. The second version
  2030. // handles everything else. The final argument only serves as discriminator and
  2031. // is unused.
  2032. template <typename T>
  2033. inline
  2034. void
  2035. SetMethodAux(T recv,
  2036. v8::Local<v8::String> name,
  2037. v8::Local<v8::FunctionTemplate> tpl,
  2038. v8::Template *) {
  2039. recv->Set(name, tpl);
  2040. }
  2041. template <typename T>
  2042. inline
  2043. void
  2044. SetMethodAux(T recv,
  2045. v8::Local<v8::String> name,
  2046. v8::Local<v8::FunctionTemplate> tpl,
  2047. ...) {
  2048. Set(recv, name, GetFunction(tpl).ToLocalChecked());
  2049. }
  2050. } // end of namespace imp
  2051. template <typename T, template <typename> class HandleType>
  2052. inline void SetMethod(
  2053. HandleType<T> recv
  2054. , const char *name
  2055. , FunctionCallback callback) {
  2056. HandleScope scope;
  2057. v8::Local<v8::FunctionTemplate> t = New<v8::FunctionTemplate>(callback);
  2058. v8::Local<v8::String> fn_name = New(name).ToLocalChecked();
  2059. t->SetClassName(fn_name);
  2060. // Note(@agnat): Pass an empty T* as discriminator. See note on
  2061. // SetMethodAux(...) above
  2062. imp::SetMethodAux(recv, fn_name, t, static_cast<T*>(0));
  2063. }
  2064. inline void SetPrototypeMethod(
  2065. v8::Local<v8::FunctionTemplate> recv
  2066. , const char* name, FunctionCallback callback) {
  2067. HandleScope scope;
  2068. v8::Local<v8::FunctionTemplate> t = New<v8::FunctionTemplate>(
  2069. callback
  2070. , v8::Local<v8::Value>()
  2071. , New<v8::Signature>(recv));
  2072. v8::Local<v8::String> fn_name = New(name).ToLocalChecked();
  2073. recv->PrototypeTemplate()->Set(fn_name, t);
  2074. t->SetClassName(fn_name);
  2075. }
  2076. //=== Accessors and Such =======================================================
  2077. inline void SetAccessor(
  2078. v8::Local<v8::ObjectTemplate> tpl
  2079. , v8::Local<v8::String> name
  2080. , GetterCallback getter
  2081. , SetterCallback setter = 0
  2082. , v8::Local<v8::Value> data = v8::Local<v8::Value>()
  2083. , v8::AccessControl settings = v8::DEFAULT
  2084. , v8::PropertyAttribute attribute = v8::None
  2085. , imp::Sig signature = imp::Sig()) {
  2086. HandleScope scope;
  2087. imp::NativeGetter getter_ =
  2088. imp::GetterCallbackWrapper;
  2089. imp::NativeSetter setter_ =
  2090. setter ? imp::SetterCallbackWrapper : 0;
  2091. v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
  2092. otpl->SetInternalFieldCount(imp::kAccessorFieldCount);
  2093. v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
  2094. obj->SetInternalField(
  2095. imp::kGetterIndex
  2096. , New<v8::External>(reinterpret_cast<void *>(getter)));
  2097. if (setter != 0) {
  2098. obj->SetInternalField(
  2099. imp::kSetterIndex
  2100. , New<v8::External>(reinterpret_cast<void *>(setter)));
  2101. }
  2102. if (!data.IsEmpty()) {
  2103. obj->SetInternalField(imp::kDataIndex, data);
  2104. }
  2105. tpl->SetAccessor(
  2106. name
  2107. , getter_
  2108. , setter_
  2109. , obj
  2110. , settings
  2111. , attribute
  2112. , signature);
  2113. }
  2114. inline bool SetAccessor(
  2115. v8::Local<v8::Object> obj
  2116. , v8::Local<v8::String> name
  2117. , GetterCallback getter
  2118. , SetterCallback setter = 0
  2119. , v8::Local<v8::Value> data = v8::Local<v8::Value>()
  2120. , v8::AccessControl settings = v8::DEFAULT
  2121. , v8::PropertyAttribute attribute = v8::None) {
  2122. HandleScope scope;
  2123. imp::NativeGetter getter_ =
  2124. imp::GetterCallbackWrapper;
  2125. imp::NativeSetter setter_ =
  2126. setter ? imp::SetterCallbackWrapper : 0;
  2127. v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
  2128. otpl->SetInternalFieldCount(imp::kAccessorFieldCount);
  2129. v8::Local<v8::Object> dataobj = NewInstance(otpl).ToLocalChecked();
  2130. dataobj->SetInternalField(
  2131. imp::kGetterIndex
  2132. , New<v8::External>(reinterpret_cast<void *>(getter)));
  2133. if (!data.IsEmpty()) {
  2134. dataobj->SetInternalField(imp::kDataIndex, data);
  2135. }
  2136. if (setter) {
  2137. dataobj->SetInternalField(
  2138. imp::kSetterIndex
  2139. , New<v8::External>(reinterpret_cast<void *>(setter)));
  2140. }
  2141. #if (NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION)
  2142. return obj->SetAccessor(
  2143. GetCurrentContext()
  2144. , name
  2145. , getter_
  2146. , setter_
  2147. , dataobj
  2148. , settings
  2149. , attribute).FromMaybe(false);
  2150. #else
  2151. return obj->SetAccessor(
  2152. name
  2153. , getter_
  2154. , setter_
  2155. , dataobj
  2156. , settings
  2157. , attribute);
  2158. #endif
  2159. }
  2160. inline void SetNamedPropertyHandler(
  2161. v8::Local<v8::ObjectTemplate> tpl
  2162. , PropertyGetterCallback getter
  2163. , PropertySetterCallback setter = 0
  2164. , PropertyQueryCallback query = 0
  2165. , PropertyDeleterCallback deleter = 0
  2166. , PropertyEnumeratorCallback enumerator = 0
  2167. , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
  2168. HandleScope scope;
  2169. imp::NativePropertyGetter getter_ =
  2170. imp::PropertyGetterCallbackWrapper;
  2171. imp::NativePropertySetter setter_ =
  2172. setter ? imp::PropertySetterCallbackWrapper : 0;
  2173. imp::NativePropertyQuery query_ =
  2174. query ? imp::PropertyQueryCallbackWrapper : 0;
  2175. imp::NativePropertyDeleter *deleter_ =
  2176. deleter ? imp::PropertyDeleterCallbackWrapper : 0;
  2177. imp::NativePropertyEnumerator enumerator_ =
  2178. enumerator ? imp::PropertyEnumeratorCallbackWrapper : 0;
  2179. v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
  2180. otpl->SetInternalFieldCount(imp::kPropertyFieldCount);
  2181. v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
  2182. obj->SetInternalField(
  2183. imp::kPropertyGetterIndex
  2184. , New<v8::External>(reinterpret_cast<void *>(getter)));
  2185. if (setter) {
  2186. obj->SetInternalField(
  2187. imp::kPropertySetterIndex
  2188. , New<v8::External>(reinterpret_cast<void *>(setter)));
  2189. }
  2190. if (query) {
  2191. obj->SetInternalField(
  2192. imp::kPropertyQueryIndex
  2193. , New<v8::External>(reinterpret_cast<void *>(query)));
  2194. }
  2195. if (deleter) {
  2196. obj->SetInternalField(
  2197. imp::kPropertyDeleterIndex
  2198. , New<v8::External>(reinterpret_cast<void *>(deleter)));
  2199. }
  2200. if (enumerator) {
  2201. obj->SetInternalField(
  2202. imp::kPropertyEnumeratorIndex
  2203. , New<v8::External>(reinterpret_cast<void *>(enumerator)));
  2204. }
  2205. if (!data.IsEmpty()) {
  2206. obj->SetInternalField(imp::kDataIndex, data);
  2207. }
  2208. #if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
  2209. tpl->SetHandler(v8::NamedPropertyHandlerConfiguration(
  2210. getter_, setter_, query_, deleter_, enumerator_, obj));
  2211. #else
  2212. tpl->SetNamedPropertyHandler(
  2213. getter_
  2214. , setter_
  2215. , query_
  2216. , deleter_
  2217. , enumerator_
  2218. , obj);
  2219. #endif
  2220. }
  2221. inline void SetIndexedPropertyHandler(
  2222. v8::Local<v8::ObjectTemplate> tpl
  2223. , IndexGetterCallback getter
  2224. , IndexSetterCallback setter = 0
  2225. , IndexQueryCallback query = 0
  2226. , IndexDeleterCallback deleter = 0
  2227. , IndexEnumeratorCallback enumerator = 0
  2228. , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
  2229. HandleScope scope;
  2230. imp::NativeIndexGetter getter_ =
  2231. imp::IndexGetterCallbackWrapper;
  2232. imp::NativeIndexSetter setter_ =
  2233. setter ? imp::IndexSetterCallbackWrapper : 0;
  2234. imp::NativeIndexQuery query_ =
  2235. query ? imp::IndexQueryCallbackWrapper : 0;
  2236. imp::NativeIndexDeleter deleter_ =
  2237. deleter ? imp::IndexDeleterCallbackWrapper : 0;
  2238. imp::NativeIndexEnumerator enumerator_ =
  2239. enumerator ? imp::IndexEnumeratorCallbackWrapper : 0;
  2240. v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
  2241. otpl->SetInternalFieldCount(imp::kIndexPropertyFieldCount);
  2242. v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
  2243. obj->SetInternalField(
  2244. imp::kIndexPropertyGetterIndex
  2245. , New<v8::External>(reinterpret_cast<void *>(getter)));
  2246. if (setter) {
  2247. obj->SetInternalField(
  2248. imp::kIndexPropertySetterIndex
  2249. , New<v8::External>(reinterpret_cast<void *>(setter)));
  2250. }
  2251. if (query) {
  2252. obj->SetInternalField(
  2253. imp::kIndexPropertyQueryIndex
  2254. , New<v8::External>(reinterpret_cast<void *>(query)));
  2255. }
  2256. if (deleter) {
  2257. obj->SetInternalField(
  2258. imp::kIndexPropertyDeleterIndex
  2259. , New<v8::External>(reinterpret_cast<void *>(deleter)));
  2260. }
  2261. if (enumerator) {
  2262. obj->SetInternalField(
  2263. imp::kIndexPropertyEnumeratorIndex
  2264. , New<v8::External>(reinterpret_cast<void *>(enumerator)));
  2265. }
  2266. if (!data.IsEmpty()) {
  2267. obj->SetInternalField(imp::kDataIndex, data);
  2268. }
  2269. #if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
  2270. tpl->SetHandler(v8::IndexedPropertyHandlerConfiguration(
  2271. getter_, setter_, query_, deleter_, enumerator_, obj));
  2272. #else
  2273. tpl->SetIndexedPropertyHandler(
  2274. getter_
  2275. , setter_
  2276. , query_
  2277. , deleter_
  2278. , enumerator_
  2279. , obj);
  2280. #endif
  2281. }
  2282. inline void SetCallHandler(
  2283. v8::Local<v8::FunctionTemplate> tpl
  2284. , FunctionCallback callback
  2285. , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
  2286. HandleScope scope;
  2287. v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
  2288. otpl->SetInternalFieldCount(imp::kFunctionFieldCount);
  2289. v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
  2290. obj->SetInternalField(
  2291. imp::kFunctionIndex
  2292. , New<v8::External>(reinterpret_cast<void *>(callback)));
  2293. if (!data.IsEmpty()) {
  2294. obj->SetInternalField(imp::kDataIndex, data);
  2295. }
  2296. tpl->SetCallHandler(imp::FunctionCallbackWrapper, obj);
  2297. }
  2298. inline void SetCallAsFunctionHandler(
  2299. v8::Local<v8::ObjectTemplate> tpl,
  2300. FunctionCallback callback,
  2301. v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
  2302. HandleScope scope;
  2303. v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
  2304. otpl->SetInternalFieldCount(imp::kFunctionFieldCount);
  2305. v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
  2306. obj->SetInternalField(
  2307. imp::kFunctionIndex
  2308. , New<v8::External>(reinterpret_cast<void *>(callback)));
  2309. if (!data.IsEmpty()) {
  2310. obj->SetInternalField(imp::kDataIndex, data);
  2311. }
  2312. tpl->SetCallAsFunctionHandler(imp::FunctionCallbackWrapper, obj);
  2313. }
  2314. //=== Weak Persistent Handling =================================================
  2315. #include "nan_weak.h" // NOLINT(build/include)
  2316. //=== ObjectWrap ===============================================================
  2317. #include "nan_object_wrap.h" // NOLINT(build/include)
  2318. //=== HiddenValue/Private ======================================================
  2319. #include "nan_private.h" // NOLINT(build/include)
  2320. //=== Export ==================================================================
  2321. inline
  2322. void
  2323. Export(ADDON_REGISTER_FUNCTION_ARGS_TYPE target, const char *name,
  2324. FunctionCallback f) {
  2325. HandleScope scope;
  2326. Set(target, New<v8::String>(name).ToLocalChecked(),
  2327. GetFunction(New<v8::FunctionTemplate>(f)).ToLocalChecked());
  2328. }
  2329. //=== Tap Reverse Binding =====================================================
  2330. struct Tap {
  2331. explicit Tap(v8::Local<v8::Value> t) : t_() {
  2332. HandleScope scope;
  2333. t_.Reset(To<v8::Object>(t).ToLocalChecked());
  2334. }
  2335. ~Tap() { t_.Reset(); } // not sure if neccessary
  2336. inline void plan(int i) {
  2337. HandleScope scope;
  2338. v8::Local<v8::Value> arg = New(i);
  2339. Call("plan", New(t_), 1, &arg);
  2340. }
  2341. inline void ok(bool isOk, const char *msg = NULL) {
  2342. HandleScope scope;
  2343. v8::Local<v8::Value> args[2];
  2344. args[0] = New(isOk);
  2345. if (msg) args[1] = New(msg).ToLocalChecked();
  2346. Call("ok", New(t_), msg ? 2 : 1, args);
  2347. }
  2348. inline void pass(const char * msg = NULL) {
  2349. HandleScope scope;
  2350. v8::Local<v8::Value> hmsg;
  2351. if (msg) hmsg = New(msg).ToLocalChecked();
  2352. Call("pass", New(t_), msg ? 1 : 0, &hmsg);
  2353. }
  2354. inline void end() {
  2355. HandleScope scope;
  2356. Call("end", New(t_), 0, NULL);
  2357. }
  2358. private:
  2359. Persistent<v8::Object> t_;
  2360. };
  2361. #define NAN_STRINGIZE2(x) #x
  2362. #define NAN_STRINGIZE(x) NAN_STRINGIZE2(x)
  2363. #define NAN_TEST_EXPRESSION(expression) \
  2364. ( expression ), __FILE__ ":" NAN_STRINGIZE(__LINE__) ": " #expression
  2365. #define NAN_EXPORT(target, function) Export(target, #function, function)
  2366. #undef TYPE_CHECK
  2367. //=== Generic Maybefication ===================================================
  2368. namespace imp {
  2369. template <typename T> struct Maybefier;
  2370. template <typename T> struct Maybefier<v8::Local<T> > {
  2371. inline static MaybeLocal<T> convert(v8::Local<T> v) {
  2372. return v;
  2373. }
  2374. };
  2375. template <typename T> struct Maybefier<MaybeLocal<T> > {
  2376. inline static MaybeLocal<T> convert(MaybeLocal<T> v) {
  2377. return v;
  2378. }
  2379. };
  2380. } // end of namespace imp
  2381. template <typename T, template <typename> class MaybeMaybe>
  2382. inline MaybeLocal<T>
  2383. MakeMaybe(MaybeMaybe<T> v) {
  2384. return imp::Maybefier<MaybeMaybe<T> >::convert(v);
  2385. }
  2386. //=== TypedArrayContents =======================================================
  2387. #include "nan_typedarray_contents.h" // NOLINT(build/include)
  2388. //=== JSON =====================================================================
  2389. #include "nan_json.h" // NOLINT(build/include)
  2390. } // end of namespace Nan
  2391. #endif // NAN_H_