Modern Caps Lock

Modern Caps Lock provides an easy way to check whether Caps Lock is active or not, and it allows you to run your code whenever Caps Lock state changes.

1. Installation
2. API
   1. onCapsLockChange
      1. Arguments
      2. Return value
   2. isCapsLockOn
      1. Arguments
      2. Return value
3. Examples
   1. Print Caps Lock state after every change
   2. Get current Caps Lock state
4. Support
   1. Supported Platforms
   2. Unsupported Platforms
5. Limitations
6. Credits

Installation

Example installation with npm:

npm install @leonabcd123/modern-caps-lock

API

onCapsLockChange

Runs the provided callback function whenever Caps Lock state is changed.

Arguments

callback: (capsState: boolean) => void: a function that takes one argument (capsState) and returns nothing. This function is executed after every Caps Lock state change.

Return value

void.

isCapsLockOn

Returns the current Caps Lock state.

Arguments

None.

Return value

capsState: boolean: a boolean representing the current Caps Lock state. If true, Caps Lock is on; if false, Caps Lock is off.

Examples

Print Caps Lock state after every change

import { onCapsLockChange } from "@leonabcd123/modern-caps-lock";

onCapsLockChange((capsState) => {
  console.log(`Caps Lock is ${capsState ? "on" : "off"}`);
});

Get current Caps Lock state

import { isCapsLockOn } from "@leonabcd123/modern-caps-lock";

if (isCapsLockOn()) {
  console.log("Caps Lock is on!");
} else {
  console.log("Caps Lock is off!");
}

Support

Supported Platforms

• Windows
• Mac
• Linux
• iPad

Unsupported Platforms

• Platforms using GBoard

Limitations

Because of browser limitations, we can only detect the Caps Lock state after a KeyboardEvent or a MouseEvent. We currently detect updates to the Caps Lock state when the following events are fired:

• keydown
• keyup
• mousedown
• mousemove
• wheel

Before any of these events are fired, Caps Lock state is off.

Credits

Created by Leon and fehmer.