@igor.dvlpr/regkeys

RegKeys

RegKeys,

an NPM package for querying Windows registry keys.

Uses the reg.exe system executable.

If you are looking for a cool implementation of this module, click here.

💖 Support further development

I work hard for every project, including this one and your support means a lot to me!
Consider buying me a coffee. ☕
Thank you for supporting my efforts! 🙏😊



@igorskyflyer

Uses the reg.exe system executable.

If you are looking for a cool implementation of this module, click here.

🕵🏼 Usage

Install it by executing:

npm i "@igor.dvlpr/regkeys"

🤹🏼 API

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 '@igor.dvlpr/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(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 '@igor.dvlpr/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(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 '@igor.dvlpr/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(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 '@igor.dvlpr/regkeys'

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

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

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 '@igor.dvlpr/regkeys'

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

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

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 '@igor.dvlpr/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(): void

Clears the cached result, if any,

returns a void.

Example

import { RegKeys } from '@igor.dvlpr/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)

---

🪪 License

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

---

🧬 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. ▶

Provided by Igor Dimitrijević (@igorskyflyer).