@babel/plugin-syntax-import-assertions

What is @babel/plugin-syntax-import-assertions?

The @babel/plugin-syntax-import-assertions package allows Babel to parse the import assertions syntax, which is a feature that enables developers to make assertions about the kind of content they are importing. This is particularly useful for ensuring that modules being imported are of the expected type, such as JSON, HTML, or other non-JavaScript resources.

What are @babel/plugin-syntax-import-assertions's main functionalities?

Parsing import assertions

This feature allows Babel to understand and parse the import assertions syntax, which is used to assert the type of file being imported. In this code sample, an assertion is made that the imported module 'data.json' is of type 'json'.

import json from './data.json' assert { type: 'json' };

Other packages similar to @babel/plugin-syntax-import-assertions

@babel/plugin-proposal-json-strings

This package allows Babel to transform JSON string literals into actual JSON objects. It is similar to @babel/plugin-syntax-import-assertions in that it deals with JSON within the context of JavaScript modules, but it focuses on the transformation of JSON strings rather than the import assertions syntax.

README

@babel/plugin-syntax-import-assertions

Allow parsing of the module assertion attributes in the import statement

See our website @babel/plugin-syntax-import-assertions for more information.

Install

Using npm:

npm install --save-dev @babel/plugin-syntax-import-assertions

or using yarn:

yarn add @babel/plugin-syntax-import-assertions --dev

Changelog

v7.25.6 (2024-08-29)

:bug: Bug Fix

• babel-generator
  • #16783 Properly print inner comments in TS array types (@nicolo-ribaudo)
  • #16775 fix: jsx whitespace is not properly preserved when retainLines (@liuxingbaoyu)
• babel-traverse
  • #16727 fix: path.getAssignmentIdentifiers may be undefined (@liuxingbaoyu)
• babel-parser
  • #16761 fix: improve static canFollowModifier checks (@JLHwung)
• babel-helpers, babel-plugin-transform-optional-chaining, babel-runtime-corejs3
  • #16769 Only wrap functions in superPropertyGet helper (@nicolo-ribaudo)

:nail_care: Polish

• babel-generator, babel-plugin-transform-async-to-generator, babel-plugin-transform-block-scoping, babel-plugin-transform-class-properties, babel-plugin-transform-classes, babel-plugin-transform-duplicate-named-capturing-groups-regex, babel-plugin-transform-named-capturing-groups-regex, babel-plugin-transform-react-jsx-development, babel-plugin-transform-react-jsx, babel-plugin-transform-react-pure-annotations, babel-plugin-transform-regenerator, babel-plugin-transform-runtime, babel-preset-env
  • #16780 Do not enforce printing space between ( and comments (@nicolo-ribaudo)
• babel-plugin-syntax-import-assertions, babel-plugin-syntax-import-attributes
  • #16781 Don't throw when enabling both syntax-import-{assertions,attributes} (@nicolo-ribaudo)
• babel-generator
  • #16782 TS union/intersection nested in union does not need parens (@nicolo-ribaudo)

:house: Internal

• babel-generator
  • #16777 Remove unused parent params in the generator (@nicolo-ribaudo)