Unverified Commit 20f2b0b3 authored by Fabian Mastenbroek's avatar Fabian Mastenbroek Committed by GitHub

Add example for polyfilling DOMParser in Node (#10782)

This change updates the README of the `react-intl` example to show how to use
the FormattedHTMLMessage component from `react-intl` in Node environments when
using pre-v4 versions.
parent 69984de7
...@@ -57,4 +57,17 @@ $ npm start ...@@ -57,4 +57,17 @@ $ npm start
You can then switch your browser's language preferences to French and refresh the page to see the UI update accordingly. You can then switch your browser's language preferences to French and refresh the page to see the UI update accordingly.
### FormattedHTMLMessage support (react-intl pre-v4)
Out of the box, this example does not support the use of the `FormattedHTMLMessage` component on the server due to `DOMParser` not being present in a Node environment.
This functionality is deprecated and has been removed as of react-intl 4.0
If you still want to enable this feature, you should install a `DOMParser` implementation (e.g. `xmldom` or `jsdom`) and enable the polyfill in `server.js`:
```js
// Polyfill Node with `DOMParser` required by formatjs.
// See: https://github.com/zeit/next.js/issues/10533
const { DOMParser } = require('xmldom')
global.DOMParser = DOMParser
```
[react intl]: https://github.com/yahoo/react-intl [react intl]: https://github.com/yahoo/react-intl
...@@ -4,6 +4,12 @@ const IntlPolyfill = require('intl') ...@@ -4,6 +4,12 @@ const IntlPolyfill = require('intl')
Intl.NumberFormat = IntlPolyfill.NumberFormat Intl.NumberFormat = IntlPolyfill.NumberFormat
Intl.DateTimeFormat = IntlPolyfill.DateTimeFormat Intl.DateTimeFormat = IntlPolyfill.DateTimeFormat
// Polyfill DOMParser for **pre-v4** react-intl used by formatjs.
// Only needed when using FormattedHTMLMessage. Make sure to install `xmldom`.
// See: https://github.com/zeit/next.js/issues/10533
// const { DOMParser } = require('xmldom')
// global.DOMParser = DOMParser
const { readFileSync } = require('fs') const { readFileSync } = require('fs')
const { basename } = require('path') const { basename } = require('path')
const { createServer } = require('http') const { createServer } = require('http')
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment