Javascript FSO Name Property

Javascript FileSystemObject (FSO) provides a Name property that can be accessed using file object or folder object. Name property returns the name of the specified file or folder. FSO Name property also provides the functionality to rename the specified file or folder if a new name is assigned to this property. GetFile method of javascript FSO returns the file object that supports the Name property and allows you to get or set the name of the specified file. Similarly GetFolder method of FSO returns the folder object that supports the Name property and allows you to get or set the name of the specified folder.

Syntax for Javascript FSO Name Property

fileObj.Name

// or
folderObj.Name 

Above code syntaxes show that both file object and folder object returned by the Javascript FSO methods such as GetFile or GetFolder provides the access to the Name property that enables you to get or set the name of the specified file or folder at the client’s machine.

To assign the new name to the specified or folder you can use the following code syntax:

fileObj.Name = "newName.ext"

// or
folderObj.Name = "newName"

Example 1

File object to get the value of Name property

<script type="text/javascript">
    // initialize ActiveXObject and create an object of Scripting.FileSystemObject.
    var fso = new ActiveXObject("Scripting.FileSystemObject");

    // object created for file object returned by GetFile method
    var fileObj = fso.GetFile("C:\\Temp\\textFile.txt");
    document.write("<b>File Name: </b>" + fileObj.Name);
    document.write("<br />");

    // Output: 
    // File Name: textFile.txt
</script> 

Example 2

Folder object to get the value of Name property

<script type="text/javascript">
    // initialize ActiveXObject and create an object of Scripting.FileSystemObject.
    var fso = new ActiveXObject("Scripting.FileSystemObject");

    // object created for folder object returned by GetFolder method
    var folderObj = fso.GetFolder("C:\\Temp\\myFolder");
    document.write("<b>Folder Name: </b>" + folderObj.Name);
    document.write("<br />");

    // Output: 
    // Folder Name: myFolder
</script>

Continue to next tutorial: Javascript FSO ParentFolder Property to learn how to get name of the folder in which the specified file or folder is located.