extendscript-es5-shim


A collection of ES5 shims for polyfiling Exendscript (for es6 shims take a look at https://github.com/ExtendScript/extendscript-es6-shim)

Installation

npm init -y
npm install extendscript-es5-shim

Usage

Array, String and Function notes

All polyfills could be used in your code.

Object notes

Because it is impossible to emulate property descriptors in ES3 engine, the following functions are just a mocks and you should avoid to use them in your code if it is possible, only shim thirdparty libraries:

$3

Supports only _data descriptor_. _Writable_, _enumerable_ and _configurable_ properties of descriptor are ignored. If you try to define _set_ or _get_ propperty this methods will throw an error.

$3

Supports only _data descriptor_. _Configurable_ property of descriptor is always TRUE. _Enumerable_ and _writable_ properties of descriptor will be always TRUE on user defined objects, but may vary on build in.

$3

Only validate input parameter and return input if it is an object.

$3

Validates input and returns TRUE, FALSE, FALSE, respectively if input parametr is an object.

These functions you can use in your code:

$3

Support of property descriptor is in the same level as in _defineProperty_. Although, you can use this function in your code like this:

``js
var obj1 = {a : 1};
var obj2 = Object.create(obj1, {b : {value : 2}});
`

or like that:

`js
var obj1 = {a : 1};
var obj2 = Object.create(obj1);
obj2.b = 2;
`




$3

This function uses reflection interface, that ExtendScript provides (see JavaScript Tools Guide), to get own properties of an object (enumerable or not). But ther is no guarantee that the order of enumeration will be the same as in _for in loop_.

$3

Use _for in loop_ along with _hasOwnProperty_ function to get own enumerable properties in object.

$3

Use build in __proto__ property as return value.

Development

- Install the devDependencies by running npm install
- Bundle the index.js by running npm run bundle
- Add new prototypes in the respective folders
- If you need new folders, add the folder to the top of ./bin/concat.js into the folders` array

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Manuel 💻

EugenTepin 💻

Michael Deal 💻

Andy Dayton 💻

Todd Fast 💻

silmelumenn 💻

This project follows the all-contributors specification. Contributions of any kind welcome!