Object

Folder

Represents a file-system folder or directory in a platform-independent manner.

Hierarchy

Folder

Properties

Name	Type	Access	Description
	String	readonly	The full path name for the referenced folder in URI notation.
	Boolean	readonly	When true, the object refers to a file system alias or shortcut.
static	Folder	readonly	The folder containing the application data for all users.
static	Folder	readonly	In Mac OS, a Folder object for the folder containing the bundle of the running application.
static	Folder	readonly	A Folder object for the folder containing common files for all programs installed by the user.
	Date	readonly	The creation date of the referenced folder, or null if the object does not refer to a folder on disk.
static	Folder	read/write	A Folder object for the current folder.
static	Folder	readonly	A Folder object for the folder that contains the user’s desktop.
	String	readonly	The localized name portion of the absolute URI for the referenced folder, without the path specification.
	String	read/write	A message describing the most recent file system error.
	Boolean	readonly	When true, this object refers to a folder that currently exists in the file system.
static	String	readonly	The name of the current file system.
	String	readonly	The platform-specific name of the referenced folder as a full path name.
	String	readonly	The full path name for the referenced folder in URI notation. .
	Date	readonly	The date of the referenced folder's last modification, or null if the object does not refer to a folder on disk.
static	Folder	readonly	A folder pointing to the user's My Documents folder.
	String	readonly	The folder name portion of the absolute URI for the referenced file, without the path specification.
	Folder	readonly	TThe Folder object for the folder that contains this folder, or null if this object refers to the root folder of a volume.
	String	readonly	The path portion of the object absolute URI for the referenced file, without the folder name.
	String	readonly	The path name for the referenced folder in URI notation, relative to the current folder.
static	Folder	readonly	A Folder object for the folder containing the executable image of the running application.
static	Folder	readonly	A Folder object for the folder containing the operating system files.
static	Folder	readonly	A Folder object for the default folder for temporary files.
static	Folder	readonly	A Folder object for the folder containing deleted items. On Windows, the trash folder is a virtual folder containing a database; therefore, the property value is null on Windows.
static	Folder	readonly	A Folder object for the folder containing the user's application data.

Methods

→ Folder

Creates and returns a new Folder object referring to a given file-system location.

path? String The absolute or relative path to the folder associated with this object, specified in URI format.

→ Boolean

Changes the path specification of the referenced folder.

path String A string containing the new path, absolute or relative to the current folder.

→ Boolean

Creates a folder at the location given by this object's path property.

→ String

Decodes a UTF-8 encoded string as required by RFC 2396, and returns the decoded string.

uri String The UTF-8 string to decode.

→ String

Encodes a string as required by RFC 2396, and returns the encoded string.

name String The string to encode.

→ Boolean

Opens this folder in the platform-specific file browser (as if it had been double-clicked in the file browser).

→ Array

Retrieves the contents of this folder, filtered by the supplied mask.

mask Varies A search mask for file names, specified as a string or a function.

→ String

Retrieves and returns the path for this file, relative to the specified base path, in URI notation.

basePath? String A base path in URI notation.

→ Boolean

Reports whether a given encoding is available.

name String The encoding name.

→ Boolean

Deletes the folder associated with this object from disk immediately, without moving it to the system trash.

→ Boolean

Renames the associated folder.

newName String The new folder name, with no path information.

→ Folder

Attempts to resolve the file-system alias or shortcut that this object refers to.

→ Folder

Opens the built-in platform-specific file-browsing dialog, and creates a new File or Folder object for the selected file or folder.

prompt String The prompt text, if the dialog allows a prompt.

→ Folder

Opens the built-in platform-specific file-browsing dialog, and creates a new File or Folder object for the selected file or folder.

prompt String The prompt text, if the dialog allows a prompt.

→ String

Creates and returns a serialized string representation of this object.

→ String

Converts this object to a string.

Object of 13

Properties elsewhere that hold a Folder.

File.parent Folder.appData Folder.appPackage Folder.commonFiles Folder.current Folder.desktop Folder.myDocuments Folder.parent Folder.startup Folder.system Folder.temp Folder.trash Folder.userData

Return 4

Methods that return a Folder.

Folder.Folder()Folder.resolve()Folder.selectDialog()Folder.selectDlg()