Skip to content

A script to create a native ECMAScript module version of react and react-dom to be used in browsers

Notifications You must be signed in to change notification settings

wearespindle/react-ecmascript

Repository files navigation

react-ecmascript

ECMAScript module versions of

  • react.production.min.js
  • react-dom.production.min.js
  • react.development.js
  • react-dom.development.js

with the right exports and imports to use them directly in browsers which support ECMAScript modules and module loading.

react and react-dom version: 16.6.3

usage

pkg.module

The module property in package.json only supports one file, and this creates four modules to use. Therefor the pkg.module isn't used and you need to copy the files yourself. Or generate them before you use them in development or during your build step.

during development import them directly from unpkg.com

import React from 'https://unpkg.com/[email protected]/react.development.mjs';
import ReactDOM from 'https://unpkg.com/[email protected]/react-dom.development.mjs';

copy paste

In the root of this repo are the four script files.

  • react.development.mjs
  • react-dom.development.mjs
  • react.production.min.mjs
  • react-dom.production.min.mjs

You can copy paste the relevant files and upload them to wherever you want. They should work right away because the module specifier is a relative one.

As an NPM module in node

Install

npm i react-ecmascript

Than generate the sources in Node

const reactEcmascript = require('react-ecmascript');

reactEcmascript('someUrl') // optional uri as argument, pass in the folder. the correct filename will get appended
  .then(sources => {
    console.log(sources);
    /*
    {
      'react.production.min.mjs': 'content as string',
      'react-dom.production.min.mjs': 'content as string',
      'react.development.mjs': 'content as string',
      'react-dom.development.mjs': 'content as string'
    }
    */

    // do something with these sources, like saving them to disk to use them in your project
  });

Replacing the import uri for react automatically

The optional argument that can be passed to the function exported by the react-ecmascript module is the directory where these files will be made available to be used in a browser. The relevant filename to import will get appended automatically (production.min or development). In most cases this will not be needed though.

Usage with Rollup

The files generated by this script can be used directly in Rollup. To use these files through Rollup you will need to add the correct settings to the Rollup config.

Add react and react-dom to the output.paths object so Rollup knows with what to replace the module specifier in the files that import react and react-dom:

{
  react: urlWhereTheReactFileWillBeDeployed,
  'react-dom': urlWhereTheReactDOMFileWillBeDeployed
}

and also flag them as being external in the external array to prevent unfound modules messages:

[
  'react',
  'react-dom',
  `${directoryWhereTheFilesWillBeDeployed}react.development.mjs`,
  `${directoryWhereTheFilesWillBeDeployed}react-dom.development.mjs`,
  `${directoryWhereTheFilesWillBeDeployed}react.production.min.mjs`,
  `${directoryWhereTheFilesWillBeDeployed}react-dom.production.min.mjs`
]

You can also reference the files directly from the node_modules directory in Rollup if you're using the 'rollup-plugin-node-resolve' plugin.

Notice

When react and react-dom have a module entry in their package.json and they will have formalized the top-level ES exports this module will be deprecated. Untill then this is the next best thing if you want to use react and react-dom as ECMAScript modules in a browser.

About

A script to create a native ECMAScript module version of react and react-dom to be used in browsers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published