ACROCase

Acronyms Consistently Retain Original Case

The web platform has hundreds of APIs that contain acronyms. With remarkable consistency, those acronyms are kept uppercase: innerHTML, XMLDocument, toJSON, encodeURIComponent. ACROCase is a name for this convention, and an ESLint plugin to enforce it.

Acronyms in Web APIs

100+ HTML* interfaces. 80+ SVG*. 50+ CSS*. 30+ each for GPU*, RTC*, and XR*.

Not Acronyms

Id is an abbreviation, not an acronym.The DOM uses getElementById, elementId, clientId.Similarly, the Internationalization API is Intl, not INTL.

Chaining

When two acronyms are adjacent, one gets titlecased.XMLHttpRequest should be XMLHTTPRequest by the convention's own logic, but XMLHTTP is where you lose the boundary.

The Web Crypto API titlecases all its acronyms for the same reason:

• AESCBCParams is written AesCbcParams
• RSAOAEPParams is written RsaOaepParams

WebRTC does the same selectively: RTCDtlsTransport, RTCRtpSender.But not always: RTCDTMFSender keeps DTMF uppercase.

The Convention

ESLint Plugin

npm install eslint-plugin-acrocase --save-dev

{
  "plugins": ["acrocase"],
  "rules": {
    "acrocase/acrocase": "error"
  }
}

Auto-fixable. Ships with a dictionary of 139 acronyms. Extensible:

{
  "acrocase/acrocase": ["error", {
    "acronyms": ["GCP", "NATS"]
  }]
}