Update: don't bother with CScript. See Javascript from the command line to learn about doing this with Rhino; you can also do it with node.js.

I recently had to write a script that would make global replacements in a text file on a client's machine. Much as I love python (I look forward to telling you about the fun I'm having with python-calais), it was one of those tasks that just cried out "perl". Unfortunately, I couldn't take perl's existence for granted on the client's computers, and having them install it was too much trouble.

Between the the string manipulation functions and the regular expression, standard input, and standard output support, the combination of cscript and JScript gives all Windows machines a powerful text processing tool right out of the box.

I could, however, take everything in a typical Windows installation for granted, and it turned out that Microsoft's JScript implementation of Javascript could do everything I needed. (VBScript equivalents of what I describe here shouldn't be much different.) With Javascript's roots as a web scripting language, I knew that safety reasons prevented it from having a lot of file input and especially output capabilities, but I learned that not only are these fairly easy, they can be done with standard input and output, so that a command in a batch file can pipe content through JScript scripts just like it can with perl or python scripts.

The Windows utility that lets you run scripts from the command line is called cscript.exe. It assumes that a script file with an extension of "js" is a JScript program, although it can run VBScript programs as well.

The following script performs a global replacement using the target and replacement strings passed as command line parameters. It demonstrates a few nice things:

• WScript.Echo writes to standard output. CScript is essentially a less-GUI oriented version of the wscript.exe Windows scripting engine, so many basic library calls include the latter's name.

• The WScript object has a StdIn method to read from standard input.

• WScript.Arguments stores the command line parameters used when invoking the script.

• You can use regular expressions with UNIXy syntax. To use a variable such as target in a regular expression, you need the RegExp object, as the sample script demonstrates, but the comment preceding that line shows how a hardcoded regular expression would not need this object.

// replace.js: globally replace one string with another. 
// See directions for syntax. 

function directions() {
  WScript.Echo("Enter\n");
  WScript.Echo("cscript //Nologo replace.js targetstring \
replstring < infile.txt > outfile.txt");
     WScript.Echo("\nEnclose strings that have spaces in quotation marks.");
}
function processTextStream() {
    target = WScript.Arguments.Item(0);
    newString = WScript.Arguments.Item(1);
    while (!WScript.StdIn.AtEndOfStream) {
        line = WScript.StdIn.ReadAll();
        // If I wasn't passing a variable as the first argument 
        // of line.replace, I could use normal regex syntax like
        // line.replace(/Robert/g,"Bob")
        line = line.replace(RegExp(target,"g"),newString)
            WScript.Echo(line);
    }
}

// --------------------------------------------------

if (WScript.Arguments.length < 2) {
    directions();
}
else {
    processTextStream();
}

As the directions show, you could run this at a Windows command line like this:

   cscript //Nologo replace.js Robert Bob < oldaddrbook.txt > newaddrbook.txt

If you're redirecting the output to a file and don't want the Microsoft cscript banner in that file, don't forget the //Nologo parameter. Several other parameters are available.

Between the string manipulation functions and the regular expression, standard input, and standard output support, this combination of the cscript engine and the J(ava)Script programming language gives all Windows machines a powerful text processing tool right out of the box.