azu / node-browser-polyfill-gap

The gap issue between Node.js and Browser polyfills.

Node.js and Browser polyfill gap

webpack and browserify user polyfill libraries for in-browser usage.

For example, webpack and browserify alias assert module to commonjs-assert in browser-env.

polyfill library

• webpack:
  • webpack/node-libs-browser: The node core libs for in browser usage.
• browserify:
  • substack/browserify-handbook: how to build modular applications with browserify
  • node-browserify/builtins.js at master · substack/node-browserify

Issues

• webpack: Incompatibility between Node.js core libs and webpack's lib · Issue #78 · webpack/node-libs-browser

Purpose

Recently, Node.js have upgraded own core module like assert. But, polyfill module like commonjs-assert does not follow the breaking change.

This repository aim to collect the gap issue between Node.js and Browser polyfills.

Test Suite

Node.js >= 10.0.0

npm run test:node 

webpack CI Test Status

npm run test:webpack 

browserify CI Test Status

npm run test:browserify

Gap list

Node.js	Browser polyfill	Issue	Link
assert	defunctzombie/commonjs-assert	Error code and Error message are different	Issue, Article
		assert.deepEqual does't support Map, Set, Iterator etc...	Issue, Document, Release
		require("assert").strict	Docs, Release
		assert.rejects()	Release
		assert.doesNotReject()	Release
		Compatible issue with assert.fail(), assert.ok(), and assert.ifError()	No arguments behavior. Release
buffer	feross/buffer	---
child_process	---	---
cluster	---	---
console	Raynos/console-browserify	---
constants	juliangruber/constants-browserify	---
crypto	crypto-browserify/crypto-browserify	---
dgram	---	---
dns	---	---
domain	bevry/domain-browser	---
events	Gozala/events	eventNames	Issue
		getMaxListeners	Issue
		prependListener	Issue
		prependOnceListener	Issue
		off	Issue
fs	---	---
http	jhiesey/stream-http	---
https	substack/https-browserify	---
module	---	---
net	---	---
os	CoderPuppy/os-browserify	os.constants
path	substack/path-browserify	path.posix	Issue
		path.parse(path)	Issue
		path.win32
		path.format(pathObject)
process	shtylman/node-process	process.channel
		process.platform	Issue
		process.execArgv	Issue
		process.cpuUsage([previousValue])
		process.emitWarning(warning[, options])
punycode	bestiejs/punycode.js	---
querystring	mike-spainhower/querystring	---
readline	---	---
repl	---	---
stream	substack/stream-browserify	---
string_decoder	rvagg/string_decoder	TODO	Repository
sys	defunctzombie/node-util	TODO
timers	jryans/timers-browserify	---
tls	---	---
tty	substack/tty-browserify	---
url	defunctzombie/node-url	url.URL(WHATWG URL)	Release, Document, Issue
		url.format does't support WHATWG URL	Release, Document
util	defunctzombie/node-util	util.callbackify(original)
		util.inspect.custom
		util.inspect.defaultOptions
		util.promisify(original)
		util.promisify.custom
		util.inspect() options maxArrayLength, breakLength
		util.isDeepStrictEqual
		util.isDeepStrictEqual
vm	substack/vm-browserify	vm.isContext(sandbox)
zlib	devongovett/browserify-zlib	zlib.bytesRead

node-browser-polyfill-gap's Issues

assert: support custom error

nodejs/node#15304

util.isDeep[Strict]Equal

Status: PR
Issue: nodejs/node#16084

assert: .throws accept objects

assert: .throws accept objects by BridgeAR · Pull Request #17584 · nodejs/node

assert: strict mode

const assert = require('assert').strict;

https://nodejs.org/en/blog/release/v9.9.0/