A polyfill that lets you forget the crude American spelling of Javascript symbols in lieu of the proper British spellings.

💂‍DISCLAIMER 💂‍: Before using please read the disclaimer below.

Install with yarn or npm

npm install british.js --save

yarn add british.js

Import the parts of the library you wish to use.

import 'british.js';
import 'british.js/extended';

The following corrections are supported in the main library

Example usage:

Maths.round(3.1459); // => 3
Maths.floor(3.1459); // => 3
Maths.ceil(3.1459); // => 4
Maths.abs(-42); // => 42
Maths.min(100, 200, 300); // => 100
Maths.max(100, 200, 300); // => 300

• window.screen.colourDepth
• CanvasGradient.addColourStop()

• WebGLProgramme
• WebGLRenderingContext.isProgramme()
• WebGLRenderingContext.useProgramme()
• WebGLRenderingContext.linkProgramme()
• WebGLRenderingContext.createProgramme()
• WebGLRenderingContext.deleteProgramme()
• WebGLRenderingContext.validateProgramme()

The spelling of this has not changed but when pronouncing it you are encouraged to say "scheduled" with an "SH" sound rather than a "SK" sound.

Additional British-isms are available by using the extended API

import 'british.js/extended';

This gives you access to the following polyfills.

• RegExp -> Butters
• Event.isTrusted -> Event.notDodgy
• Error -> Cockup
• SyntaxError -> SyntaxCockup
• TypeError -> TypeCockup
• RangeError -> RangeCockup

This library is meant to be ironic and is not intended for actual use. Please please don't use it. It is not production ready.

Do you want to join the patriotic cause of correcting the spelling errors in Javascript? Pull requests are more than welcome. All things that are strictly spelling corrections should be added to src/proper.js. Anything that is a more drastic renaming should be added to src/extended.js.

Please document all new APIs in the README.md and remember to write tests!

british.js has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Cheekily created by Christian Schlensker who is not British nor associated with the British government in any way. Cheers!