https://github.com/fartinmartin/extendscript-ponyfills

Modern JavaScript ponyfills for ES6. Intended for use with Extendscript.
https://github.com/fartinmartin/extendscript-ponyfills

Last synced: 26 days ago
JSON representation

Modern JavaScript ponyfills for ES6. Intended for use with Extendscript.

• Host: GitHub
• URL: https://github.com/fartinmartin/extendscript-ponyfills
• Owner: fartinmartin
• License: mit
• Created: 2022-09-03T21:23:52.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-12-02T04:10:22.000Z (about 1 month ago)
• Last Synced: 2024-12-02T05:21:15.979Z (about 1 month ago)
• Language: TypeScript
• Size: 163 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# extendscript-ponyfills

## Why

ExtendScript is stuck in ES3, but we like our simple ES6 methods. A common solution is to polyfill these methods, but I'll let [sindresorhus](https://github.com/sindresorhus/ponyfill#how-are-ponyfills-better-than-polyfills) and [hyperbrew](https://hyperbrew.co/blog/top-2-extendscript-mistakes-and-how-to-avoid-them/) explain why that's not a good idea, especially so in Adobe-land.

## Usage

```

npm i extendscript-ponyfills

```

```ts

import { arrayFrom, forEach } from "extendscript-ponyfills";

(function script() {

	const comp = app.project.activeItem;

	if (!(comp && comp instanceof CompItem)) {

		return alert("No comp found.");

	}

	const layers: Layer[] = arrayFrom(comp.layers);

	if (layers.length) {

		forEach(layers, (layer) => alert(layer.name));

	} else {

		alert("No layers found.");

	}

})();

```

---

Or, download the [latest release](https://github.com/fartinmartin/extendscript-ponyfills/releases) to [`#include`](https://extendscript.docsforadobe.dev/extendscript-tools-features/preprocessor-directives.html) in your `.jsx` script.

```js

// @include "path/to/extendscript-ponyfills-vX.X.X.jsx"

(function script() {

	var comp = app.project.activeItem;

	if (!(comp && comp instanceof CompItem)) {

		return alert("No comp found.");

	}

	var layers = PONIES.arrayFrom(comp.layers);

	if (layers.length) {

		PONIES.forEach(layers, function (layer) {

			alert(layer.name);

		});

	} else {

		alert("No layers found.");

	}

})();

```

> By default the ponyfills are namespaced to `PONIES`—you can change this name on the first line of the .jsx, or remove the IIFE entirely.

## Ponyfills

### Array

- `arrayFrom`

- `difference`

- `differenceWith`

- `every`

- `fill`

- `filter`

- `find`

- `findIndex`

- `flat`

- `flatMap`

- `forEach`

- `groupBy`

- `includes`

- `indexOf`

- `intersection`

- `intersectionWith`

- `isArray`

- `lastIndexOf`

- `map`

- `reduce`

- `some`

### String

- `padEnd`

- `endsWith`

- `includes`

- `padStart`

- `repeat`

- `startsWith`

- `trim`

### Object

- `assign`

- `entries`

### Function

- `bind`

## Similar Projects

- klustre's [`extender`](https://github.com/Klustre/extender)