📃 Table of Contents

• Features
• Usage
• API
• Changelog
• Support
• License
• Related
• Author

🤖 Features

• 🔍 Enumerates Windows Registry subkeys via the native reg.exe command
• 🗂 Automatically expands short hive names to their full forms
• ⚡ Supports both synchronous and asynchronous usage patterns
• 🧠 Caches retrieved keys for faster repeated lookups, with optional refresh
• ✅ Checks for the existence of single or multiple registry keys
• 🎯 Allows custom predicate‑based key matching
• 🔡 Offers optional case‑sensitive matching
• ♻️ Provides a way to clear cached results
• 🖥 Ensures execution only on Windows systems
• 🔧 Includes static variables for easier hives referencing

🕵🏼 Usage

Install it by executing:

npm i @igorskyflyer/regkeys

🤹🏼‍♂️ API

constructor()

constructor(key): RegKeys

Creates the RegKeys object. Do not forget to set the key parameter.

• key: string, the key you later want to manipulate with, i.e. read keys, check for children keys, etc.,

key can either be an expanded or a non-expanded key, i.e.:

| Non-expanded | Expanded | | :----------: | :------------------------: | | HKCR | HKEY_CLASSES_ROOT | | HKCU | HKEY_CURRENT_USER | | HKLM | HKEY_LOCAL_MACHINE | | HKU | HKEY_USERS | | HKCC | HKEY_CURRENT_CONFIGURATION |

returns the RegKeys object.

Example

import { RegKeys } from '@igorskyflyer/regkeys'

// for your convenience, you can use forward slashes,
// since internally Windows only supports back slashes,
// which need to be escaped and look bad 😫😒

// so...

// 😒
const registry: RegKeys = new RegKeys('HKLM\\Software')

// is the same as

// 🥳🎊
const registry: RegKeys = new RegKeys('HKLM/Software')

get()

get(forceRefresh: boolean = false): string[]

Gets the keys for the given root key.

• forceRefresh: boolean, indicates whether the registry should be queried again since the result of this method is cached internally, for performance,

returns a string[].

Example

import { RegKeys } from '@igorskyflyer/regkeys'

const registry: RegKeys = new RegKeys('HKCR')
const keys: string[] = registry.get()

// do something with the keys,
// it's your fate, unlock it 😛
keys.forEach((key: string) => {
  console.log(key)
})

hasKey()

hasKey(searchFor: string, caseSensitive: boolean = false): boolean

Checks whether the given key is a direct child of the currently selected key.

• searchFor: string, the key to search for,
• caseSensitive: boolean, indicates whether the search should be case-sensitive or not. Defaults to false,

returns a boolean.

NOTE: it will auto-fetch the keys if the internal cache is empty = you didn't call get() before calling this method.

Example

import { RegKeys } from '@igorskyflyer/regkeys'

const registry: RegKeys = new RegKeys('HKLM/Software')

// let's see if we have any
// Microsoft software on our Windows PC
// 😂😂😂😂😂😂
console.log(registry.hasKey('Microsoft'))

hasKeys()

hasKeys(searchFor: string[], caseSensitive: boolean = false): boolean

Checks whether the given keys are a direct child of the currently selected key.

• list: string[], the keys to search for,
• caseSensitive: boolean, indicates whether the search should be case-sensitive or not. Defaults to false,

returns a boolean[].

NOTE: it will auto-fetch the keys if the internal cache is empty = you didn't call get() before calling this method.

Example

import { RegKeys } from '@igorskyflyer/regkeys'

const registry: RegKeys = new RegKeys('HKLM/Software')

console.log(registry.hasKeys(['Microsoft', 'Macromedia', 'Google', 'Adobe']))

has()

has(value: string|string[], caseSensitive: boolean = false): boolean|boolean[]

A generic method that checks whether the given key(s) is/are a direct child of the currently selected key. See both hasKey() and hasKeys(). You can use this method for own convenience, it will pick the suited method depending on the type of the value parameter,

• value: string|string[], the key(s) to search for,
• caseSensitive: boolean, indicates whether the search should be case-sensitive or not. Defaults to false,

returns a boolean|boolean[].

NOTE: it will auto-fetch the keys if the internal cache is empty = you didn't call get() before calling this method.

Example

import { RegKeys } from '@igorskyflyer/regkeys'

const registry: RegKeys = new RegKeys('HKLM/Software')

console.log(registry.has('Microsoft'))
console.log(registry.has(['Microsoft', 'Macromedia', 'Google', 'Adobe']))

searchFor()

searchFor(value: string, predicate: SearchPredicate): boolean

Provides a way to do keys-checking using a custom predicate function,

• value: string, the key name to find,
• predicate: SearchPredicate, the callback that will do the actual querying, see the code example below,

returns a boolean, i.e. true upon finding the first match or false if no match is found or any of the both required parameters aren't set.

NOTE: it will auto-fetch the keys if the internal cache is empty = you didn't call get() before calling this method.

Example

import { RegKeys } from '@igorskyflyer/regkeys'

const registry: RegKeys = new RegKeys('HKLM/Software')

// useful for custom search algorithms/behavior,
// like demonstrated here, case-insensitive partial search
console.log(
  registry.searchFor('micro', (key: string, searchFor: string, i: number) => {
    return key.toLowerCase().indexOf(searchFor.toLowerCase()) > -1
  })
)

clear()

clear(): void

Clears the cached result, if any,

returns a void.

Example

import { RegKeys } from '@igorskyflyer/regkeys'

const registry: RegKeys = new RegKeys('HKLM/Software')

// fetch keys and cache them
let keys = registry.get()

// 🔮 do something with the registry ⭐

// clear the cached result
registry.clear()

// refetch (new) keys
keys = registry.get()

console.log(keys)

📝 Changelog

📑 The changelog is available here, CHANGELOG.md.

🪪 License

Licensed under the MIT license which is available here, MIT license.

💖 Support

🧬 Related

@igor.dvlpr/is-rootdir

🔼 Provides a way to check if the given path is the root drive/directory. ⛔

@igor.dvlpr/mp3size

🧮 Calculates an estimated file size of Mp3 files. 🎶

@igor.dvlpr/aria

🧬 Meet Aria, an efficient Adblock filter list compiler, with many features that make your maintenance of Adblock filter lists a breeze! 🗡

@igor.dvlpr/keppo

🎡 Parse, manage, compare and output SemVer-compatible version numbers. 🛡

@igor.dvlpr/simple-exec

🕺 Command. Execution. Made. Simple. ▶

👨🏻‍💻 Author

Created by Igor Dimitrijević (@igorskyflyer).