deleteValue

Category: Registry Operations

Namespace: web.registry.deleteValue

Description

Deletes a specific value from a Windows Registry key under HKEY_CURRENT_USER. The key itself remains.

Syntax

const success = await web.registry.deleteValue({
    keyPath: 'Software\\MyApp',
    valueName: 'Setting'
});

Parameters

• keyPath (required) - Registry key path under HKEY_CURRENT_USER
• valueName (required) - Name of the registry value to delete
• rootKey (optional) - Currently ignored; always uses HKEY_CURRENT_USER

Returns

Promise<boolean> - Returns a promise that resolves with true if the value was deleted, false if it doesn't exist or deletion failed

Examples

Simple example

const success = await web.registry.deleteValue({
    keyPath: 'Software\\MyApp',
    valueName: 'TempSetting'
});

if (success) {
    console.log('Value deleted successfully');
} else {
    console.log('Value not found or deletion failed');
}

Clear user preference

// Reset to default by deleting saved preference
const success = await web.registry.deleteValue({
    keyPath: 'Software\\MyApp\\Settings',
    valueName: 'Theme'
});

if (success) {
    console.log('Theme reset to default');
}

Clean up old settings

const oldSettings = ['OldSetting1', 'OldSetting2', 'Deprecated'];

for (const name of oldSettings) {
    await web.registry.deleteValue({
        keyPath: 'Software\\MyApp',
        valueName: name
    });
}
console.log('Old settings cleaned up');

Use Cases

• Remove obsolete registry values
• Reset settings to defaults
• Clean up temporary registry entries
• Remove user preferences
• Delete cached data from registry

Notes

• Always operates under HKEY_CURRENT_USER root key
• Only deletes the value, not the key itself
• Returns false if the value doesn't exist
• Returns false if the key doesn't exist
• Use deleteKey() to delete an entire key with all its values