provides access to the windows registry through the REG tool
npm install winreg
shell
npm install winreg
`
If you prefer to install _without the development tools used to generate the HTML documentation_ (into a production environment for example) you should use the following command.
`shell
npm install winreg --production
`
Note that the development dependencies will not be installed if this package was installed as a dependency of another package.
Documentation ##
The documentation is generated using jsdoc with the docstrap template. You can view the API documentation online, download the latest documentation or generate it from the sourcecode.
$3
View the latest docs online.
$3
To download the latest docs from GIT the following command is used.
`shell
npm run-script download-docs
`
$3
To generate the docs from the sources you can use the following command.
`shell
npm run-script generate-docs
`
Note that generating the docs requires the development dependencies to be installed.
Example Usage ##
Let's start with an example. The code below lists the autostart programs of the current user.
`javascript
var Registry = require('winreg')
, regKey = new Registry({ // new operator is optional
hive: Registry.HKCU, // open registry hive HKEY_CURRENT_USER
key: '\\Software\\Microsoft\\Windows\\CurrentVersion\\Run' // key containing autostart programs
})
// list autostart programs
regKey.values(function (err, items / array of RegistryItem /) {
if (err)
console.log('ERROR: '+err);
else
for (var i=0; i
});
`
Troubleshooting ##
$3
Since Windows Vista access to certain Registry Hives (HKEY_LOCAL_MACHINE or short HKLM for example) is restricted to processes that run in a security elevated context even if the user that starts the process is an admin. You can start a console within that context by right clicking the console shortcut and selecting the item with the shield icon called "Run as administrator" from the context menu.
Under some rare circumstances access to Registry Hives or particular keys may also be blocked by some antivirus programs or the Windows Group Policy Editor (google for gpedit.msc).
You can also use the regedit.exe tool shipped with Windows to check if you actually have access.
$3
The Microsoft Windows console isn't capable of handling UTF-8 encoded text unless you set it up properly. If you see weird question marks for certain characters, it's probhably a problem with the encoding.
By default the console is setup to use an encoding that suits the language of the Windows operating system installation. Windows uses codepages to specify encodings for the console. The codepage is a unique number which is assigned to each encoding.
If you want to query the currently selected codepage you can type the command chcp (w/o parameters). To set a new codepage (UTF-8 for this example) you pass the codepage number as the only argument to chcp. The codepage value for UTF-8 is 65001.
You can easily do this from within your nodejs script by using the child_process.execSync(...) function like the following example shows.
`javascript
var execSync = require('child_process').execSync;
console.log(execSync('chcp').toString());
console.log(execSync('chcp 65001').toString());
``
chcp prior setting the console to UTF-8 and resetting the codepage after your script is done.