JavaScript.hpp

   1 /* Cycript - The Truly Universal Scripting Language
   2  * Copyright (C) 2009-2016  Jay Freeman (saurik)
   3 */
   4
   5 /* GNU Affero General Public License, Version 3 {{{ */
   6 /*
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU Affero General Public License as published by
   9  * the Free Software Foundation, either version 3 of the License, or
  10  * (at your option) any later version.
  11
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU Affero General Public License for more details.
  16
  17  * You should have received a copy of the GNU Affero General Public License
  18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 **/
  20 /* }}} */
  21
  22 #ifndef CYCRIPT_JAVASCRIPT_HPP
  23 #define CYCRIPT_JAVASCRIPT_HPP
  24
  25 #include <set>
  26 #include <string>
  27
  28 #include <JavaScriptCore/JSBase.h>
  29 #include <JavaScriptCore/JSContextRef.h>
  30 #include <JavaScriptCore/JSStringRef.h>
  31 #include <JavaScriptCore/JSObjectRef.h>
  32 #include <JavaScriptCore/JSValueRef.h>
  33
  34 #ifdef HAVE_FFI_FFI_H
  35 #include <ffi/ffi.h>
  36 #else
  37 #include <ffi.h>
  38 #endif
  39
  40 #include "Pooling.hpp"
  41 #include "String.hpp"
  42 #include "Utility.hpp"
  43
  44 extern JSStringRef Array_s;
  45 extern JSStringRef constructor_s;
  46 extern JSStringRef cy_s;
  47 extern JSStringRef cyi_s;
  48 extern JSStringRef cyt_s;
  49 extern JSStringRef length_s;
  50 extern JSStringRef message_s;
  51 extern JSStringRef name_s;
  52 extern JSStringRef pop_s;
  53 extern JSStringRef prototype_s;
  54 extern JSStringRef push_s;
  55 extern JSStringRef splice_s;
  56 extern JSStringRef toCYON_s;
  57 extern JSStringRef toJSON_s;
  58 extern JSStringRef toPointer_s;
  59 extern JSStringRef toString_s;
  60 extern JSStringRef weak_s;
  61
  62 void CYInitializeDynamic();
  63 JSGlobalContextRef CYGetJSContext();
  64 JSObjectRef CYGetGlobalObject(JSContextRef context);
  65
  66 extern "C" void CYSetupContext(JSGlobalContextRef context);
  67 const char *CYExecute(JSContextRef context, CYPool &pool, CYUTF8String code);
  68
  69 #ifndef __ANDROID__
  70 void CYCancel();
  71 #endif
  72
  73 void CYSetArgs(const char *argv0, const char *script, int argc, const char *argv[]);
  74
  75 bool CYCastBool(JSContextRef context, JSValueRef value);
  76 double CYCastDouble(JSContextRef context, JSValueRef value);
  77
  78 bool CYIsEqual(JSContextRef context, JSValueRef lhs, JSValueRef rhs);
  79 bool CYIsStrictEqual(JSContextRef context, JSValueRef lhs, JSValueRef rhs);
  80
  81 CYUTF16String CYCastUTF16String(JSStringRef value);
  82 CYUTF8String CYPoolUTF8String(CYPool &pool, JSContextRef context, JSStringRef value);
  83 const char *CYPoolCString(CYPool &pool, JSContextRef context, JSStringRef value);
  84
  85 bool CYHasProperty(JSContextRef context, JSObjectRef object, JSStringRef name);
  86 JSValueRef CYGetProperty(JSContextRef context, JSObjectRef object, size_t index);
  87 JSValueRef CYGetProperty(JSContextRef context, JSObjectRef object, JSStringRef name);
  88
  89 void CYSetProperty(JSContextRef context, JSObjectRef object, size_t index, JSValueRef value);
  90 void CYSetProperty(JSContextRef context, JSObjectRef object, JSStringRef name, JSValueRef value, JSPropertyAttributes attributes = kJSPropertyAttributeNone);
  91 void CYSetProperty(JSContextRef context, JSObjectRef object, JSStringRef name, JSValueRef (*callback)(JSContextRef, JSObjectRef, JSObjectRef, size_t, const JSValueRef[], JSValueRef *), JSPropertyAttributes attributes = kJSPropertyAttributeNone);
  92
  93 JSObjectRef CYGetPrototype(JSContextRef context, JSObjectRef object);
  94 void CYSetPrototype(JSContextRef context, JSObjectRef object, JSValueRef prototype);
  95
  96 JSValueRef CYGetCachedValue(JSContextRef context, JSStringRef name);
  97 JSObjectRef CYGetCachedObject(JSContextRef context, JSStringRef name);
  98
  99 JSValueRef CYCastJSValue(JSContextRef context, bool value);
 100 JSValueRef CYCastJSValue(JSContextRef context, double value);
 101
 102 JSValueRef CYCastJSValue(JSContextRef context, signed short int value);
 103 JSValueRef CYCastJSValue(JSContextRef context, unsigned short int value);
 104 JSValueRef CYCastJSValue(JSContextRef context, signed int value);
 105 JSValueRef CYCastJSValue(JSContextRef context, unsigned int value);
 106 JSValueRef CYCastJSValue(JSContextRef context, signed long int value);
 107 JSValueRef CYCastJSValue(JSContextRef context, unsigned long int value);
 108 JSValueRef CYCastJSValue(JSContextRef context, signed long long int value);
 109 JSValueRef CYCastJSValue(JSContextRef context, unsigned long long int value);
 110
 111 JSValueRef CYCastJSValue(JSContextRef context, JSStringRef value);
 112 JSValueRef CYCastJSValue(JSContextRef context, const char *value);
 113
 114 JSObjectRef CYCastJSObject(JSContextRef context, JSValueRef value);
 115 JSValueRef CYJSUndefined(JSContextRef context);
 116 JSValueRef CYJSNull(JSContextRef context);
 117
 118 void *CYCastPointer_(JSContextRef context, JSValueRef value, bool *guess = NULL);
 119
 120 template <typename Type_>
 121 _finline Type_ CYCastPointer(JSContextRef context, JSValueRef value, bool *guess = NULL) {
 122     return reinterpret_cast<Type_>(CYCastPointer_(context, value, guess));
 123 }
 124
 125 void CYCallFunction(CYPool &pool, JSContextRef context, ffi_cif *cif, void (*function)(), void *value, void **values);
 126 JSValueRef CYCallFunction(CYPool &pool, JSContextRef context, size_t setups, void *setup[], size_t count, const JSValueRef arguments[], bool initialize, bool variadic, const sig::Signature &signature, ffi_cif *cif, void (*function)());
 127
 128 bool CYIsCallable(JSContextRef context, JSValueRef value);
 129 JSValueRef CYCallAsFunction(JSContextRef context, JSObjectRef function, JSObjectRef _this, size_t count, const JSValueRef arguments[]);
 130
 131 const char *CYPoolCCYON(CYPool &pool, JSContextRef context, JSObjectRef object, std::set<void *> &objects);
 132 std::set<void *> *CYCastObjects(JSContextRef context, JSObjectRef _this, size_t count, const JSValueRef arguments[]);
 133
 134 struct CYHook {
 135     void *(*ExecuteStart)(JSContextRef);
 136     void (*ExecuteEnd)(JSContextRef, void *);
 137
 138     void (*CallFunction)(CYPool &, JSContextRef, ffi_cif *, void (*)(), void *, void **);
 139
 140     void (*Initialize)();
 141     void (*SetupContext)(JSContextRef);
 142
 143     void *(*CastSymbol)(const char *);
 144 };
 145
 146 struct CYRegisterHook {
 147     CYRegisterHook(CYHook *hook);
 148 };
 149
 150 JSObjectRef CYMakePointer(JSContextRef context, void *pointer, const sig::Type &type, ffi_type *ffi, JSObjectRef owner);
 151
 152 JSObjectRef CYMakeType(JSContextRef context, const sig::Type &type);
 153
 154 void CYFinalize(JSObjectRef object);
 155
 156 JSObjectRef CYObjectMakeArray(JSContextRef context, size_t length, const JSValueRef values[]);
 157
 158 size_t CYArrayLength(JSContextRef context, JSObjectRef array);
 159 JSValueRef CYArrayGet(JSContextRef context, JSObjectRef array, size_t index);
 160
 161 void CYArrayPush(JSContextRef context, JSObjectRef array, size_t length, const JSValueRef arguments[]);
 162 void CYArrayPush(JSContextRef context, JSObjectRef array, JSValueRef value);
 163
 164 bool CYGetOffset(CYPool &pool, JSContextRef context, JSStringRef value, ssize_t &index);
 165
 166 const char *CYPoolCString(CYPool &pool, JSContextRef context, JSValueRef value);
 167
 168 JSStringRef CYCopyJSString(const char *value);
 169 JSStringRef CYCopyJSString(JSStringRef value);
 170 JSStringRef CYCopyJSString(CYUTF8String value);
 171 JSStringRef CYCopyJSString(const std::string &value);
 172 JSStringRef CYCopyJSString(CYUTF16String value);
 173 JSStringRef CYCopyJSString(JSContextRef context, JSValueRef value);
 174
 175 void CYGarbageCollect(JSContextRef context);
 176 void CYDestroyContext();
 177
 178 class CYJSString {
 179   private:
 180     JSStringRef string_;
 181
 182     void Clear_() {
 183         if (string_ != NULL)
 184             JSStringRelease(string_);
 185     }
 186
 187   public:
 188     CYJSString() :
 189         string_(NULL)
 190     {
 191     }
 192
 193     CYJSString(const CYJSString &rhs) :
 194         string_(CYCopyJSString(rhs.string_))
 195     {
 196     }
 197
 198     template <typename ...Args_>
 199     CYJSString(Args_ &&... args) :
 200         string_(CYCopyJSString(cy::Forward<Args_>(args)...))
 201     {
 202     }
 203
 204     CYJSString &operator =(const CYJSString &rhs) {
 205         Clear_();
 206         string_ = CYCopyJSString(rhs.string_);
 207         return *this;
 208     }
 209
 210     CYJSString &operator =(CYJSString &&rhs) {
 211         std::swap(string_, rhs.string_);
 212         return *this;
 213     }
 214
 215     ~CYJSString() {
 216         Clear_();
 217     }
 218
 219     void Clear() {
 220         Clear_();
 221         string_ = NULL;
 222     }
 223
 224     operator JSStringRef() const {
 225         return string_;
 226     }
 227 };
 228
 229 template <size_t Size_>
 230 class CYArrayBuilder {
 231   private:
 232     JSContextRef context_;
 233     JSObjectRef &array_;
 234     size_t size_;
 235     JSValueRef values_[Size_];
 236
 237     void flush() {
 238         if (array_ == NULL)
 239             array_ = CYObjectMakeArray(context_, size_, values_);
 240         else
 241             CYArrayPush(context_, array_, size_, values_);
 242     }
 243
 244   public:
 245     CYArrayBuilder(JSContextRef context, JSObjectRef &array) :
 246         context_(context),
 247         array_(array),
 248         size_(0)
 249     {
 250     }
 251
 252     ~CYArrayBuilder() {
 253         flush();
 254     }
 255
 256     void operator ()(JSValueRef value) {
 257         if (size_ == Size_) {
 258             flush();
 259             size_ = 0;
 260         }
 261
 262         values_[size_++] = value;
 263     }
 264 };
 265
 266 #ifdef __APPLE__
 267 #define _weak __attribute__((__weak_import__));
 268 #else
 269 #define _weak
 270 #endif
 271
 272 typedef struct OpaqueJSWeakObjectMap *JSWeakObjectMapRef;
 273 typedef void (*JSWeakMapDestroyedCallback)(JSWeakObjectMapRef map, void *data);
 274
 275 extern "C" JSWeakObjectMapRef JSWeakObjectMapCreate(JSContextRef ctx, void *data, JSWeakMapDestroyedCallback destructor) _weak;
 276 extern "C" void JSWeakObjectMapSet(JSContextRef ctx, JSWeakObjectMapRef map, void *key, JSObjectRef) _weak;
 277 extern "C" JSObjectRef JSWeakObjectMapGet(JSContextRef ctx, JSWeakObjectMapRef map, void *key) _weak;
 278 extern "C" bool JSWeakObjectMapClear(JSContextRef ctx, JSWeakObjectMapRef map, void *key, JSObjectRef object) _weak;
 279 extern "C" void JSWeakObjectMapRemove(JSContextRef ctx, JSWeakObjectMapRef map, void* key) _weak;
 280
 281 typedef bool (*JSShouldTerminateCallback)(JSContextRef ctx, void *context);
 282 extern "C" void JSContextGroupSetExecutionTimeLimit(JSContextGroupRef, double limit, JSShouldTerminateCallback, void *context) _weak;
 283
 284 #endif/*CYCRIPT_JAVASCRIPT_HPP*/