org.liquidplayer.webkit.javascriptcore

Class JSObject

java.lang.Object

org.liquidplayer.webkit.javascriptcore.JSValue

org.liquidplayer.webkit.javascriptcore.JSObject

Direct Known Subclasses:

JSContext, JSDate, JSError, JSFunction, JSObjectWrapper, JSRegExp

public class JSObject
extends JSValue

A JavaScript object.

Since:

1.0

Field Summary

Fields

Modifier and Type	Field and Description
static int	JSPropertyAttributeDontDelete Specifies that the delete operation should fail on a property.
static int	JSPropertyAttributeDontEnum Specifies that a property should not be enumerated by JSPropertyEnumerators and JavaScript for...in loops.
static int	JSPropertyAttributeNone Specifies that a property has no special attributes.
static int	JSPropertyAttributeReadOnly Specifies that a property is read-only.

Constructor Summary

Constructors

Constructor and Description
JSObject() Called only by convenience subclasses.
JSObject(JSContext ctx) Creates a new, empty JavaScript object.
JSObject(JSContext ctx, java.lang.Class<?> iface) Creates a new object with function properties set for each method in the defined interface.
JSObject(JSContext ctx, java.lang.Class<?> iface, java.lang.Class<? extends JSObject> subclass) Deprecated. Function constructors have been removed from JSObject since 3.0. Use JSFunction instead.
JSObject(JSContext ctx, JSObject invoke, java.lang.reflect.Method method) Deprecated. Function constructors have been removed from JSObject since 3.0. Use JSFunction instead.
JSObject(JSContext ctx, java.util.Map map) Creates a new function object with the entries in 'map' set as properties.

Method Summary

Modifier and Type	Method and Description
JSValue	__nullFunc()
JSValue	callAsFunction() Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead
JSValue	callAsFunction(JSObject thiz) Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead
JSValue	callAsFunction(JSObject thiz, JSValue[] args) Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead
JSValue	callAsFunction(JSValue[] args) Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead
boolean	deleteProperty(java.lang.String prop) Deletes a property from the object
JSObject	getThis()
int	hashCode()
boolean	hasProperty(java.lang.String prop) Determines if the object contains a given property
boolean	isConstructor() Determines if the object is a constructor
boolean	isFunction() Determines if the object is a function
JSValue	property(java.lang.String prop) Gets the property named 'prop'
void	property(java.lang.String prop, java.lang.Object value) Sets the value of property 'prop'.
void	property(java.lang.String prop, java.lang.Object value, int attributes) Sets the value of property 'prop'
JSValue	propertyAtIndex(int index) Returns the property at index 'index'.
void	propertyAtIndex(int index, java.lang.Object value) Sets the property at index 'index'.
java.lang.String[]	propertyNames() Gets the list of set property names on the object
JSValue	prototype() Deprecated. Constructor functions have been removed from JSObject since 3.0. Use JSFunction.prototype() instead
void	prototype(JSValue proto) Deprecated. Constructor functions have been removed from JSObject since 3.0. Use JSFunction.prototype() instead

Methods inherited from class org.liquidplayer.webkit.javascriptcore.JSValue

equals, getContext, isArray, isBoolean, isDate, isEqual, isInstanceOfConstructor, isNull, isNumber, isObject, isStrictEqual, isString, isUndefined, toBoolean, toFunction, toJSArray, toJSON, toJSON, toNumber, toObject, toString, valueRef

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

JSPropertyAttributeNone

public static int JSPropertyAttributeNone

Specifies that a property has no special attributes.

JSPropertyAttributeReadOnly

public static int JSPropertyAttributeReadOnly

Specifies that a property is read-only.

JSPropertyAttributeDontEnum

public static int JSPropertyAttributeDontEnum

Specifies that a property should not be enumerated by JSPropertyEnumerators and JavaScript for...in loops.

JSPropertyAttributeDontDelete

public static int JSPropertyAttributeDontDelete

Specifies that the delete operation should fail on a property.

Constructor Detail

JSObject

public JSObject(JSContext ctx)

Creates a new, empty JavaScript object. In JS:

 
 var obj = {}; // OR
 var obj = new Object();
 
 

Parameters:

ctx - The JSContext to create the object in

Since:

1.0

JSObject

public JSObject()

Called only by convenience subclasses. If you use this, you must set context and valueRef yourself.

Since:

3.0

JSObject

public JSObject(JSContext ctx,
                java.lang.Class<?> iface)
         throws JSException

Creates a new object with function properties set for each method in the defined interface. In JS:

 
 var obj = {
     func1: function(a)   { alert(a); },
     func2: function(b,c) { alert(b+c); }
 };
 
 

Where func1, func2, etc. are defined in interface 'iface'. This JSObject must implement 'iface'.

Parameters:

ctx - The JSContext to create the object in

iface - The Java Interface defining the methods to expose to JavaScript

Throws:

JSException

Since:

1.0

JSObject

public JSObject(JSContext ctx,
                java.util.Map map)

Creates a new function object with the entries in 'map' set as properties.

Parameters:

ctx - The JSContext to create object in

map - The map containing the properties

JSObject

@Deprecated
public JSObject(JSContext ctx,
                            java.lang.Class<?> iface,
                            java.lang.Class<? extends JSObject> subclass)
                     throws JSException

Deprecated. Function constructors have been removed from JSObject since 3.0. Use JSFunction instead.

Parameters:

ctx - deprecated

iface - deprecated

subclass - deprecated

Throws:

JSException

Since:

1.0

JSObject

@Deprecated
public JSObject(JSContext ctx,
                            JSObject invoke,
                            java.lang.reflect.Method method)
                     throws JSException

Deprecated. Function constructors have been removed from JSObject since 3.0. Use JSFunction instead.

Parameters:

ctx - deprecated

invoke - deprecated

method - deprecated

Throws:

JSException

Since:

1.0

Method Detail

hasProperty

public boolean hasProperty(java.lang.String prop)

Determines if the object contains a given property

Parameters:

prop - The property to test the existence of

Returns:

true if the property exists on the object, false otherwise

Since:

1.0

property

public JSValue property(java.lang.String prop)
                 throws JSException

Gets the property named 'prop'

Parameters:

prop - The name of the property to fetch

Returns:

The JSValue of the property, or null if it does not exist

Throws:

JSException

Since:

1.0

property

public void property(java.lang.String prop,
                     java.lang.Object value,
                     int attributes)
              throws JSException

Sets the value of property 'prop'

Parameters:

prop - The name of the property to set

value - The Java object to set. The Java object will be converted to a JavaScript object automatically.

attributes - And OR'd list of JSProperty constants

Throws:

JSException

Since:

1.0

property

public void property(java.lang.String prop,
                     java.lang.Object value)
              throws JSException

Sets the value of property 'prop'. No JSProperty attributes are set.

Parameters:

prop - The name of the property to set

value - The Java object to set. The Java object will be converted to a JavaScript object automatically.

Throws:

JSException

Since:

1.0

deleteProperty

public boolean deleteProperty(java.lang.String prop)
                       throws JSException

Deletes a property from the object

Parameters:

prop - The name of the property to delete

Returns:

true if the property was deleted, false otherwise

Throws:

JSException

Since:

1.0

propertyAtIndex

public JSValue propertyAtIndex(int index)
                        throws JSException

Returns the property at index 'index'. Used for arrays.

Parameters:

index - The index of the property

Returns:

The JSValue of the property at index 'index'

Throws:

JSException

Since:

1.0

propertyAtIndex

public void propertyAtIndex(int index,
                            java.lang.Object value)
                     throws JSException

Sets the property at index 'index'. Used for arrays.

Parameters:

index - The index of the property to set

value - The Java object to set, will be automatically converted to a JavaScript value

Throws:

JSException

Since:

1.0

propertyNames

public java.lang.String[] propertyNames()

Gets the list of set property names on the object

Returns:

A string array containing the property names

Since:

1.0

isFunction

public boolean isFunction()

Determines if the object is a function

Returns:

true if the object is a function, false otherwise

Since:

1.0

isConstructor

public boolean isConstructor()

Determines if the object is a constructor

Returns:

true if the object is a constructor, false otherwise

Since:

1.0

hashCode

public int hashCode()

Overrides:

hashCode in class JSValue

getThis

public JSObject getThis()

__nullFunc

public JSValue __nullFunc()

callAsFunction

@Deprecated
public JSValue callAsFunction(JSObject thiz,
                                          JSValue[] args)
                                   throws JSException

Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead

Parameters:

thiz - deprecated

args - deprecated

Returns:

deprecated

Throws:

JSException

Since:

1.0

callAsFunction

@Deprecated
public JSValue callAsFunction(JSObject thiz)
                                   throws JSException

Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead

Parameters:

thiz - deprecated

Returns:

deprecated

Throws:

JSException

Since:

2.2

callAsFunction

@Deprecated
public JSValue callAsFunction(JSValue[] args)
                                   throws JSException

Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead

Parameters:

args - deprecated

Returns:

deprecated

Throws:

JSException

Since:

2.2

callAsFunction

@Deprecated
public JSValue callAsFunction()
                                   throws JSException

Deprecated. Function calls have been removed from JSObject since 3.0. Use JSFunction.call or JSFunction.apply instead

Returns:

deprecated

Throws:

JSException

Since:

2.2

prototype

@Deprecated
public JSValue prototype()

Deprecated. Constructor functions have been removed from JSObject since 3.0. Use JSFunction.prototype() instead

Returns:

deprecated

prototype

@Deprecated
public void prototype(JSValue proto)

Deprecated. Constructor functions have been removed from JSObject since 3.0. Use JSFunction.prototype() instead

Parameters:

proto - deprecated