API/JSObjectRef.cpp

   1 /*
   2  * Copyright (C) 2006, 2007, 2008 Apple Inc. All rights reserved.
   3  * Copyright (C) 2008 Kelvin W Sherlock (ksherlock@gmail.com)
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
  15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
  18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  */
  26
  27 #include "config.h"
  28 #include "JSObjectRef.h"
  29 #include "JSObjectRefPrivate.h"
  30
  31 #include "APICast.h"
  32 #include "CodeBlock.h"
  33 #include "DateConstructor.h"
  34 #include "ErrorConstructor.h"
  35 #include "FunctionConstructor.h"
  36 #include "Identifier.h"
  37 #include "InitializeThreading.h"
  38 #include "JSArray.h"
  39 #include "JSCallbackConstructor.h"
  40 #include "JSCallbackFunction.h"
  41 #include "JSCallbackObject.h"
  42 #include "JSClassRef.h"
  43 #include "JSFunction.h"
  44 #include "JSGlobalObject.h"
  45 #include "JSObject.h"
  46 #include "JSRetainPtr.h"
  47 #include "JSString.h"
  48 #include "JSValueRef.h"
  49 #include "ObjectPrototype.h"
  50 #include "PropertyNameArray.h"
  51 #include "RegExpConstructor.h"
  52
  53 using namespace JSC;
  54
  55 JSClassRef JSClassCreate(const JSClassDefinition* definition)
  56 {
  57     initializeThreading();
  58     RefPtr<OpaqueJSClass> jsClass = (definition->attributes & kJSClassAttributeNoAutomaticPrototype)
  59         ? OpaqueJSClass::createNoAutomaticPrototype(definition)
  60         : OpaqueJSClass::create(definition);
  61
  62     return jsClass.release().leakRef();
  63 }
  64
  65 JSClassRef JSClassRetain(JSClassRef jsClass)
  66 {
  67     jsClass->ref();
  68     return jsClass;
  69 }
  70
  71 void JSClassRelease(JSClassRef jsClass)
  72 {
  73     jsClass->deref();
  74 }
  75
  76 JSObjectRef JSObjectMake(JSContextRef ctx, JSClassRef jsClass, void* data)
  77 {
  78     ExecState* exec = toJS(ctx);
  79     APIEntryShim entryShim(exec);
  80
  81     if (!jsClass)
  82         return toRef(constructEmptyObject(exec));
  83
  84     JSCallbackObject<JSNonFinalObject>* object = JSCallbackObject<JSNonFinalObject>::create(exec, exec->lexicalGlobalObject(), exec->lexicalGlobalObject()->callbackObjectStructure(), jsClass, data);
  85     if (JSObject* prototype = jsClass->prototype(exec))
  86         object->setPrototype(exec->globalData(), prototype);
  87
  88     return toRef(object);
  89 }
  90
  91 JSObjectRef JSObjectMakeFunctionWithCallback(JSContextRef ctx, JSStringRef name, JSObjectCallAsFunctionCallback callAsFunction)
  92 {
  93     ExecState* exec = toJS(ctx);
  94     APIEntryShim entryShim(exec);
  95
  96     Identifier nameID = name ? name->identifier(&exec->globalData()) : Identifier(exec, "anonymous");
  97
  98     return toRef(JSCallbackFunction::create(exec, exec->lexicalGlobalObject(), callAsFunction, nameID));
  99 }
 100
 101 JSObjectRef JSObjectMakeConstructor(JSContextRef ctx, JSClassRef jsClass, JSObjectCallAsConstructorCallback callAsConstructor)
 102 {
 103     ExecState* exec = toJS(ctx);
 104     APIEntryShim entryShim(exec);
 105
 106     JSValue jsPrototype = jsClass ? jsClass->prototype(exec) : 0;
 107     if (!jsPrototype)
 108         jsPrototype = exec->lexicalGlobalObject()->objectPrototype();
 109
 110     JSCallbackConstructor* constructor = JSCallbackConstructor::create(exec, exec->lexicalGlobalObject(), exec->lexicalGlobalObject()->callbackConstructorStructure(), jsClass, callAsConstructor);
 111     constructor->putDirect(exec->globalData(), exec->propertyNames().prototype, jsPrototype, DontEnum | DontDelete | ReadOnly);
 112     return toRef(constructor);
 113 }
 114
 115 JSObjectRef JSObjectMakeFunction(JSContextRef ctx, JSStringRef name, unsigned parameterCount, const JSStringRef parameterNames[], JSStringRef body, JSStringRef sourceURL, int startingLineNumber, JSValueRef* exception)
 116 {
 117     ExecState* exec = toJS(ctx);
 118     APIEntryShim entryShim(exec);
 119
 120     Identifier nameID = name ? name->identifier(&exec->globalData()) : Identifier(exec, "anonymous");
 121
 122     MarkedArgumentBuffer args;
 123     for (unsigned i = 0; i < parameterCount; i++)
 124         args.append(jsString(exec, parameterNames[i]->ustring()));
 125     args.append(jsString(exec, body->ustring()));
 126
 127     JSObject* result = constructFunction(exec, exec->lexicalGlobalObject(), args, nameID, sourceURL->ustring(), TextPosition(OrdinalNumber::fromOneBasedInt(startingLineNumber), OrdinalNumber::first()));
 128     if (exec->hadException()) {
 129         if (exception)
 130             *exception = toRef(exec, exec->exception());
 131         exec->clearException();
 132         result = 0;
 133     }
 134     return toRef(result);
 135 }
 136
 137 JSObjectRef JSObjectMakeArray(JSContextRef ctx, size_t argumentCount, const JSValueRef arguments[],  JSValueRef* exception)
 138 {
 139     ExecState* exec = toJS(ctx);
 140     APIEntryShim entryShim(exec);
 141
 142     JSObject* result;
 143     if (argumentCount) {
 144         MarkedArgumentBuffer argList;
 145         for (size_t i = 0; i < argumentCount; ++i)
 146             argList.append(toJS(exec, arguments[i]));
 147
 148         result = constructArray(exec, argList);
 149     } else
 150         result = constructEmptyArray(exec);
 151
 152     if (exec->hadException()) {
 153         if (exception)
 154             *exception = toRef(exec, exec->exception());
 155         exec->clearException();
 156         result = 0;
 157     }
 158
 159     return toRef(result);
 160 }
 161
 162 JSObjectRef JSObjectMakeDate(JSContextRef ctx, size_t argumentCount, const JSValueRef arguments[],  JSValueRef* exception)
 163 {
 164     ExecState* exec = toJS(ctx);
 165     APIEntryShim entryShim(exec);
 166
 167     MarkedArgumentBuffer argList;
 168     for (size_t i = 0; i < argumentCount; ++i)
 169         argList.append(toJS(exec, arguments[i]));
 170
 171     JSObject* result = constructDate(exec, exec->lexicalGlobalObject(), argList);
 172     if (exec->hadException()) {
 173         if (exception)
 174             *exception = toRef(exec, exec->exception());
 175         exec->clearException();
 176         result = 0;
 177     }
 178
 179     return toRef(result);
 180 }
 181
 182 JSObjectRef JSObjectMakeError(JSContextRef ctx, size_t argumentCount, const JSValueRef arguments[],  JSValueRef* exception)
 183 {
 184     ExecState* exec = toJS(ctx);
 185     APIEntryShim entryShim(exec);
 186
 187     JSValue message = argumentCount ? toJS(exec, arguments[0]) : jsUndefined();
 188     Structure* errorStructure = exec->lexicalGlobalObject()->errorStructure();
 189     JSObject* result = ErrorInstance::create(exec, errorStructure, message);
 190
 191     if (exec->hadException()) {
 192         if (exception)
 193             *exception = toRef(exec, exec->exception());
 194         exec->clearException();
 195         result = 0;
 196     }
 197
 198     return toRef(result);
 199 }
 200
 201 JSObjectRef JSObjectMakeRegExp(JSContextRef ctx, size_t argumentCount, const JSValueRef arguments[],  JSValueRef* exception)
 202 {
 203     ExecState* exec = toJS(ctx);
 204     APIEntryShim entryShim(exec);
 205
 206     MarkedArgumentBuffer argList;
 207     for (size_t i = 0; i < argumentCount; ++i)
 208         argList.append(toJS(exec, arguments[i]));
 209
 210     JSObject* result = constructRegExp(exec, exec->lexicalGlobalObject(),  argList);
 211     if (exec->hadException()) {
 212         if (exception)
 213             *exception = toRef(exec, exec->exception());
 214         exec->clearException();
 215         result = 0;
 216     }
 217
 218     return toRef(result);
 219 }
 220
 221 JSValueRef JSObjectGetPrototype(JSContextRef ctx, JSObjectRef object)
 222 {
 223     ExecState* exec = toJS(ctx);
 224     APIEntryShim entryShim(exec);
 225
 226     JSObject* jsObject = toJS(object);
 227     return toRef(exec, jsObject->prototype());
 228 }
 229
 230 void JSObjectSetPrototype(JSContextRef ctx, JSObjectRef object, JSValueRef value)
 231 {
 232     ExecState* exec = toJS(ctx);
 233     APIEntryShim entryShim(exec);
 234
 235     JSObject* jsObject = toJS(object);
 236     JSValue jsValue = toJS(exec, value);
 237
 238     jsObject->setPrototypeWithCycleCheck(exec->globalData(), jsValue.isObject() ? jsValue : jsNull());
 239 }
 240
 241 bool JSObjectHasProperty(JSContextRef ctx, JSObjectRef object, JSStringRef propertyName)
 242 {
 243     ExecState* exec = toJS(ctx);
 244     APIEntryShim entryShim(exec);
 245
 246     JSObject* jsObject = toJS(object);
 247
 248     return jsObject->hasProperty(exec, propertyName->identifier(&exec->globalData()));
 249 }
 250
 251 JSValueRef JSObjectGetProperty(JSContextRef ctx, JSObjectRef object, JSStringRef propertyName, JSValueRef* exception)
 252 {
 253     ExecState* exec = toJS(ctx);
 254     APIEntryShim entryShim(exec);
 255
 256     JSObject* jsObject = toJS(object);
 257
 258     JSValue jsValue = jsObject->get(exec, propertyName->identifier(&exec->globalData()));
 259     if (exec->hadException()) {
 260         if (exception)
 261             *exception = toRef(exec, exec->exception());
 262         exec->clearException();
 263     }
 264     return toRef(exec, jsValue);
 265 }
 266
 267 void JSObjectSetProperty(JSContextRef ctx, JSObjectRef object, JSStringRef propertyName, JSValueRef value, JSPropertyAttributes attributes, JSValueRef* exception)
 268 {
 269     ExecState* exec = toJS(ctx);
 270     APIEntryShim entryShim(exec);
 271
 272     JSObject* jsObject = toJS(object);
 273     Identifier name(propertyName->identifier(&exec->globalData()));
 274     JSValue jsValue = toJS(exec, value);
 275
 276     if (attributes && !jsObject->hasProperty(exec, name))
 277         jsObject->methodTable()->putDirectVirtual(jsObject, exec, name, jsValue, attributes);
 278     else {
 279         PutPropertySlot slot;
 280         jsObject->methodTable()->put(jsObject, exec, name, jsValue, slot);
 281     }
 282
 283     if (exec->hadException()) {
 284         if (exception)
 285             *exception = toRef(exec, exec->exception());
 286         exec->clearException();
 287     }
 288 }
 289
 290 JSValueRef JSObjectGetPropertyAtIndex(JSContextRef ctx, JSObjectRef object, unsigned propertyIndex, JSValueRef* exception)
 291 {
 292     ExecState* exec = toJS(ctx);
 293     APIEntryShim entryShim(exec);
 294
 295     JSObject* jsObject = toJS(object);
 296
 297     JSValue jsValue = jsObject->get(exec, propertyIndex);
 298     if (exec->hadException()) {
 299         if (exception)
 300             *exception = toRef(exec, exec->exception());
 301         exec->clearException();
 302     }
 303     return toRef(exec, jsValue);
 304 }
 305
 306
 307 void JSObjectSetPropertyAtIndex(JSContextRef ctx, JSObjectRef object, unsigned propertyIndex, JSValueRef value, JSValueRef* exception)
 308 {
 309     ExecState* exec = toJS(ctx);
 310     APIEntryShim entryShim(exec);
 311
 312     JSObject* jsObject = toJS(object);
 313     JSValue jsValue = toJS(exec, value);
 314
 315     jsObject->methodTable()->putByIndex(jsObject, exec, propertyIndex, jsValue, false);
 316     if (exec->hadException()) {
 317         if (exception)
 318             *exception = toRef(exec, exec->exception());
 319         exec->clearException();
 320     }
 321 }
 322
 323 bool JSObjectDeleteProperty(JSContextRef ctx, JSObjectRef object, JSStringRef propertyName, JSValueRef* exception)
 324 {
 325     ExecState* exec = toJS(ctx);
 326     APIEntryShim entryShim(exec);
 327
 328     JSObject* jsObject = toJS(object);
 329
 330     bool result = jsObject->methodTable()->deleteProperty(jsObject, exec, propertyName->identifier(&exec->globalData()));
 331     if (exec->hadException()) {
 332         if (exception)
 333             *exception = toRef(exec, exec->exception());
 334         exec->clearException();
 335     }
 336     return result;
 337 }
 338
 339 void* JSObjectGetPrivate(JSObjectRef object)
 340 {
 341     JSObject* jsObject = toJS(object);
 342
 343     if (jsObject->inherits(&JSCallbackObject<JSGlobalObject>::s_info))
 344         return jsCast<JSCallbackObject<JSGlobalObject>*>(jsObject)->getPrivate();
 345     if (jsObject->inherits(&JSCallbackObject<JSNonFinalObject>::s_info))
 346         return jsCast<JSCallbackObject<JSNonFinalObject>*>(jsObject)->getPrivate();
 347
 348     return 0;
 349 }
 350
 351 bool JSObjectSetPrivate(JSObjectRef object, void* data)
 352 {
 353     JSObject* jsObject = toJS(object);
 354
 355     if (jsObject->inherits(&JSCallbackObject<JSGlobalObject>::s_info)) {
 356         jsCast<JSCallbackObject<JSGlobalObject>*>(jsObject)->setPrivate(data);
 357         return true;
 358     }
 359     if (jsObject->inherits(&JSCallbackObject<JSNonFinalObject>::s_info)) {
 360         jsCast<JSCallbackObject<JSNonFinalObject>*>(jsObject)->setPrivate(data);
 361         return true;
 362     }
 363
 364     return false;
 365 }
 366
 367 JSValueRef JSObjectGetPrivateProperty(JSContextRef ctx, JSObjectRef object, JSStringRef propertyName)
 368 {
 369     ExecState* exec = toJS(ctx);
 370     APIEntryShim entryShim(exec);
 371     JSObject* jsObject = toJS(object);
 372     JSValue result;
 373     Identifier name(propertyName->identifier(&exec->globalData()));
 374     if (jsObject->inherits(&JSCallbackObject<JSGlobalObject>::s_info))
 375         result = jsCast<JSCallbackObject<JSGlobalObject>*>(jsObject)->getPrivateProperty(name);
 376     else if (jsObject->inherits(&JSCallbackObject<JSNonFinalObject>::s_info))
 377         result = jsCast<JSCallbackObject<JSNonFinalObject>*>(jsObject)->getPrivateProperty(name);
 378     return toRef(exec, result);
 379 }
 380
 381 bool JSObjectSetPrivateProperty(JSContextRef ctx, JSObjectRef object, JSStringRef propertyName, JSValueRef value)
 382 {
 383     ExecState* exec = toJS(ctx);
 384     APIEntryShim entryShim(exec);
 385     JSObject* jsObject = toJS(object);
 386     JSValue jsValue = value ? toJS(exec, value) : JSValue();
 387     Identifier name(propertyName->identifier(&exec->globalData()));
 388     if (jsObject->inherits(&JSCallbackObject<JSGlobalObject>::s_info)) {
 389         jsCast<JSCallbackObject<JSGlobalObject>*>(jsObject)->setPrivateProperty(exec->globalData(), name, jsValue);
 390         return true;
 391     }
 392     if (jsObject->inherits(&JSCallbackObject<JSNonFinalObject>::s_info)) {
 393         jsCast<JSCallbackObject<JSNonFinalObject>*>(jsObject)->setPrivateProperty(exec->globalData(), name, jsValue);
 394         return true;
 395     }
 396     return false;
 397 }
 398
 399 bool JSObjectDeletePrivateProperty(JSContextRef ctx, JSObjectRef object, JSStringRef propertyName)
 400 {
 401     ExecState* exec = toJS(ctx);
 402     APIEntryShim entryShim(exec);
 403     JSObject* jsObject = toJS(object);
 404     Identifier name(propertyName->identifier(&exec->globalData()));
 405     if (jsObject->inherits(&JSCallbackObject<JSGlobalObject>::s_info)) {
 406         jsCast<JSCallbackObject<JSGlobalObject>*>(jsObject)->deletePrivateProperty(name);
 407         return true;
 408     }
 409     if (jsObject->inherits(&JSCallbackObject<JSNonFinalObject>::s_info)) {
 410         jsCast<JSCallbackObject<JSNonFinalObject>*>(jsObject)->deletePrivateProperty(name);
 411         return true;
 412     }
 413     return false;
 414 }
 415
 416 bool JSObjectIsFunction(JSContextRef, JSObjectRef object)
 417 {
 418     CallData callData;
 419     JSCell* cell = toJS(object);
 420     return cell->methodTable()->getCallData(cell, callData) != CallTypeNone;
 421 }
 422
 423 JSValueRef JSObjectCallAsFunction(JSContextRef ctx, JSObjectRef object, JSObjectRef thisObject, size_t argumentCount, const JSValueRef arguments[], JSValueRef* exception)
 424 {
 425     ExecState* exec = toJS(ctx);
 426     APIEntryShim entryShim(exec);
 427
 428     JSObject* jsObject = toJS(object);
 429     JSObject* jsThisObject = toJS(thisObject);
 430
 431     if (!jsThisObject)
 432         jsThisObject = exec->globalThisValue();
 433
 434     MarkedArgumentBuffer argList;
 435     for (size_t i = 0; i < argumentCount; i++)
 436         argList.append(toJS(exec, arguments[i]));
 437
 438     CallData callData;
 439     CallType callType = jsObject->methodTable()->getCallData(jsObject, callData);
 440     if (callType == CallTypeNone)
 441         return 0;
 442
 443     JSValueRef result = toRef(exec, call(exec, jsObject, callType, callData, jsThisObject, argList));
 444     if (exec->hadException()) {
 445         if (exception)
 446             *exception = toRef(exec, exec->exception());
 447         exec->clearException();
 448         result = 0;
 449     }
 450     return result;
 451 }
 452
 453 bool JSObjectIsConstructor(JSContextRef, JSObjectRef object)
 454 {
 455     JSObject* jsObject = toJS(object);
 456     ConstructData constructData;
 457     return jsObject->methodTable()->getConstructData(jsObject, constructData) != ConstructTypeNone;
 458 }
 459
 460 JSObjectRef JSObjectCallAsConstructor(JSContextRef ctx, JSObjectRef object, size_t argumentCount, const JSValueRef arguments[], JSValueRef* exception)
 461 {
 462     ExecState* exec = toJS(ctx);
 463     APIEntryShim entryShim(exec);
 464
 465     JSObject* jsObject = toJS(object);
 466
 467     ConstructData constructData;
 468     ConstructType constructType = jsObject->methodTable()->getConstructData(jsObject, constructData);
 469     if (constructType == ConstructTypeNone)
 470         return 0;
 471
 472     MarkedArgumentBuffer argList;
 473     for (size_t i = 0; i < argumentCount; i++)
 474         argList.append(toJS(exec, arguments[i]));
 475     JSObjectRef result = toRef(construct(exec, jsObject, constructType, constructData, argList));
 476     if (exec->hadException()) {
 477         if (exception)
 478             *exception = toRef(exec, exec->exception());
 479         exec->clearException();
 480         result = 0;
 481     }
 482     return result;
 483 }
 484
 485 struct OpaqueJSPropertyNameArray {
 486     WTF_MAKE_FAST_ALLOCATED;
 487 public:
 488     OpaqueJSPropertyNameArray(JSGlobalData* globalData)
 489         : refCount(0)
 490         , globalData(globalData)
 491     {
 492     }
 493
 494     unsigned refCount;
 495     JSGlobalData* globalData;
 496     Vector<JSRetainPtr<JSStringRef> > array;
 497 };
 498
 499 JSPropertyNameArrayRef JSObjectCopyPropertyNames(JSContextRef ctx, JSObjectRef object)
 500 {
 501     JSObject* jsObject = toJS(object);
 502     ExecState* exec = toJS(ctx);
 503     APIEntryShim entryShim(exec);
 504
 505     JSGlobalData* globalData = &exec->globalData();
 506
 507     JSPropertyNameArrayRef propertyNames = new OpaqueJSPropertyNameArray(globalData);
 508     PropertyNameArray array(globalData);
 509     jsObject->methodTable()->getPropertyNames(jsObject, exec, array, ExcludeDontEnumProperties);
 510
 511     size_t size = array.size();
 512     propertyNames->array.reserveInitialCapacity(size);
 513     for (size_t i = 0; i < size; ++i)
 514         propertyNames->array.append(JSRetainPtr<JSStringRef>(Adopt, OpaqueJSString::create(array[i].ustring()).leakRef()));
 515
 516     return JSPropertyNameArrayRetain(propertyNames);
 517 }
 518
 519 JSPropertyNameArrayRef JSPropertyNameArrayRetain(JSPropertyNameArrayRef array)
 520 {
 521     ++array->refCount;
 522     return array;
 523 }
 524
 525 void JSPropertyNameArrayRelease(JSPropertyNameArrayRef array)
 526 {
 527     if (--array->refCount == 0) {
 528         APIEntryShim entryShim(array->globalData, false);
 529         delete array;
 530     }
 531 }
 532
 533 size_t JSPropertyNameArrayGetCount(JSPropertyNameArrayRef array)
 534 {
 535     return array->array.size();
 536 }
 537
 538 JSStringRef JSPropertyNameArrayGetNameAtIndex(JSPropertyNameArrayRef array, size_t index)
 539 {
 540     return array->array[static_cast<unsigned>(index)].get();
 541 }
 542
 543 void JSPropertyNameAccumulatorAddName(JSPropertyNameAccumulatorRef array, JSStringRef propertyName)
 544 {
 545     PropertyNameArray* propertyNames = toJS(array);
 546     APIEntryShim entryShim(propertyNames->globalData());
 547     propertyNames->add(propertyName->identifier(propertyNames->globalData()));
 548 }