Obsolete since JSAPI 8
This feature is obsolete. Although it is still supported by browsers, its usage is discouraged in new projects. Try to avoid using it.
Create an alias for a native property.
||Pointer to a JS context from which to derive runtime information. Requires request. In a
||Object for which to create the alias.|
||Name of the property for which to create an alias.|
||Alias name to assign to the property.|
JS_AliasProperty assigns an alternate name for a property associated with a native object.
obj is the object to which the property belongs.
name is the property's current name in the object, and
alias is the alternate name to assign to the property.
This feature has been removed.
An alias does not replace a property's name; it supplements it, providing a second way to reference a property. If the alias is successfully created and associated with the property,
JS_TRUE. Creating an alias does not change the length of the property array.
If the property name you specify does not exist,
JS_AliasProperty reports an error, and returns
JS_FALSE. If the property is currently out of scope, already exists, or the alias itself cannot be assigned to the property,
JS_AliasProperty does not report an error, but returns
Once you create an alias, you can reassign it to other properties as needed. Aliases can also be deleted. Deleting an alias does not delete the property to which it refers.