@jsep-plugin/assignment

A JSEP plugin for adding assignment expression support. Allows expressions of the form:

jsep('a = 2');
jsep('a += 2');
jsep('a++');
jsep('--aa');

Install

npm install @jsep-plugin/assignment
# or
yarn add @jsep-plugin/assignment

Usage

import jsep from 'jsep';
import jsepAssignment from '@jsep-plugin/assignment';
jsep.plugins.register(jsepAssignment);

Meta

LICENSE (MIT)

1.4.0 (2024-11-05)

Bug Fixes

• add license file to build output (f6678fb), closes #267

Features

• add nullish coallescing (??) and exponentiation (**) binary_ops (7321a7b), closes #268

1.3.9 (2024-07-12)

Bug Fixes

• add types add/remove/removeAll functions (b4a5b1a), closes #238
• add types for SequenceExpressions (d0cf015), closes #261
• detect unexpected ] in expression "[1,2][]" (70b8ea6), closes #256
• do not access prototype (037d1db), closes #239
• throwError return type (e0df539), closes #252
• update Array elements typing (097ae12)

1.3.8 (2022-12-06)

Bug Fixes

• support TypeScript's Node16 resolution (0c2cb45)

1.3.7 (2022-09-18)

Bug Fixes

• add "types" export (505a81a)
• export default IPlugin from all plugins (cd38da5), closes #231

1.3.6 (2022-04-27)

Bug Fixes

• update release on package.json change (c1ceb54)

1.3.4 (2022-03-22)

Bug Fixes

• embed correct version into builds (9e90f3d), closes #216

1.3.3 (2022-03-22)

Bug Fixes

• add version to plugin for testing (1a148c7)

1.3.2 (2022-03-22)

Bug Fixes

• pass next version into build script (8270873)
• update commitPaths (3a1cc14)

1.3.1 (2022-03-22)

Bug Fixes

• test change to ternary (33f0494)
• test change to ternary (fca0aa5)

1.3.0 (2022-02-28)

Bug Fixes

• types for optional member expression now in generic baseType (79fb0dc), closes #200

Features

• assignment right-to-left and precedence with ternary (e5652eb), closes #189
• simplify ternary since to stop handling ':' binary operator (4196623)

1.3.0-beta.1 (2021-12-13)

Bug Fixes

• types for optional member expression now in generic baseType (79fb0dc), closes #200

Features

• assignment right-to-left and precedence with ternary (e5652eb), closes #189
• simplify ternary since to stop handling ':' binary operator (4196623)

1.2.0 (2021-10-31)

Features

• add right-associative support for binary operators (2da8834), closes #195

1.1.2 (2021-10-17)

Bug Fixes

• add missing optional property to types (e2f758e), closes #185

1.1.1 (2021-10-13)

Bug Fixes

• literal 'raw' value now matches input string (432c514), closes #192

1.1.0 (2021-10-03)

Features

• add optional chaining support (?.) (56d1e3d)

1.0.3 (2021-09-02)

Bug Fixes

• firefox compatibility (3e51523), closes #178

1.0.2 - 2021-08-26

Republish to include types.

1.0.1 - 2021-08-24

Fixed support for CommonJS modules. This is only a republish.

1.0.0 - 2021-08-22

Rewrote to ESM, added a plugin system, and fixed numerous grammar issues. For most standard use-cases, this release should not be a breaking change, as every effort was made to maintain compatibility.

Breaking Changes

• renamed build folder to dist (#130). The package file structure is now:

  ├── CHANGELOG.md
  ├── LICENSE
  ├── README.md
  ├── package.json
  ├── dist
  │   ├── jsep.js
  │   ├── jsep.min.js
  │   ├── cjs
  │   │   ├── jsep.cjs.js
  │   │   ├── jsep.cjs.min.js
  │   ├── iife
  │   │   ├── jsep.iife.js
  │   │   ├── jsep.iife.min.js

• Removed LogicalExpression and treat it as a BinaryExpression (#100)
• Call arguments must be either all comma-separated or all space-separated, but not mixed
• unary expressions with no argument now throw missing unaryOp argument
• binary expressions now require the left-hand side to exist
• conditional (ternary) expressions with no condition now throw unexpected "?"
• . now throws unexpected .
• ()() now throws unexpected "("
• a.this, a.true, a.false, a.null now match esprima and treat the property as an identifier instead of a literal or ThisExpression

Added

• Added a plugin system, including plugins for
  • arrow expressions (() => ...)
  • assigment and update expressions (a = 2, a++)
  • async/await (await a.find(async (v1, v2) => await v1(v2)))
  • comments (/* .. */ and // ...)
  • new expressions (new Date())
  • object expressions ({a: 1, b})
  • regex support (/123/ig)
  • spread operator (fn(...a), [1, ...b], {...c})
  • template expressions (`hi ${name}`, msg`hig ${name}`)

Updated

• (1, 2) now returns a SequenceExpression instead of throwing an Unclosed ( error
• moved the ConditionExpression (ternary) into a plugin, but it is still included by default

0.4.0 - 2021-03-21

Added

• You can add or remove additional valid identifier chars.
• Support for gobble properties from array/strings. e.g. ([1].length)

Updated

• Updated several dependancies for audit fixes.

0.3.5 - 2018-08-23

Updated

• Development dependencies update for audit fixes.

0.3.4 - 2018-03-29

Fixed

• Fixed identifiers as custom ops (#68,#83)

0.3.3 - 2017-12-16

Notice

• No functional changes, only updated support for typescript definitions.
• There may be a few known issues, check the issue page for details.

  Changed

• Updated typings.
• Updated grunt-uglify for 0.03 kB smaller jsep.min.js! :)

0.3.2 - 2017-08-31

Notice

First version that was using a CHANGELOG.md.

Added

• Typings
• Functions to remove all binary/unary/etc. ops.

Fixed

• Supports multiline expressions.