IDirectory Interface
Packages > fluid-framework > IDirectory
Interface describing actions on a directory.
Signature:
export interface IDirectory extends Map<string, any>, IEventProvider<IDirectoryEvents>, Partial<IDisposable>
Extends: , IDirectoryEvents,
Remarks
When used as a Map, operates on its keys.
Properties
| Property | Type | Description |
|---|---|---|
| absolutePath | The absolute path of the directory. |
Methods
| Method | Description |
|---|---|
| countSubDirectory() | Get the number of sub directory within the directory. |
| createSubDirectory(subdirName) | Creates an IDirectory child of this IDirectory, or retrieves the existing IDirectory child if one with the same name already exists. |
| deleteSubDirectory(subdirName) | Deletes an IDirectory child of this IDirectory, if it exists, along with all descendent keys and directories. |
| get(key) | Retrieves the value stored at the given key from the directory. |
| getSubDirectory(subdirName) | Gets an IDirectory child of this IDirectory, if it exists. |
| getWorkingDirectory(relativePath) | Get an IDirectory within the directory, in order to use relative paths from that location. |
| hasSubDirectory(subdirName) | Checks whether this directory has a child directory with the given name. |
| set(key, value) | Sets the value stored at key to the provided value. |
| subdirectories() | Gets an iterator over the IDirectory children of this IDirectory. |
Events
absolutePath
The absolute path of the directory.
Signature:
readonly absolutePath: string;
Methods
countSubDirectory
Get the number of sub directory within the directory.
Signature:
countSubDirectory?(): number;
Returns:
The number of sub directory within a directory.
createSubDirectory
Creates an IDirectory child of this IDirectory, or retrieves the existing IDirectory child if one with the same name already exists.
Signature:
createSubDirectory(subdirName: string): IDirectory;
Parameters
| Parameter | Type | Description |
|---|---|---|
| subdirName | Name of the new child directory to create |
Returns:
The IDirectory child that was created or retrieved
deleteSubDirectory
Deletes an IDirectory child of this IDirectory, if it exists, along with all descendent keys and directories.
Signature:
deleteSubDirectory(subdirName: string): boolean;
Parameters
| Parameter | Type | Description |
|---|---|---|
| subdirName | Name of the child directory to delete |
Returns:
True if the IDirectory existed and was deleted, false if it did not exist
get
Retrieves the value stored at the given key from the directory.
Signature:
get<T = any>(key: string): T | undefined;
Parameters
| Parameter | Type | Description |
|---|---|---|
| key | Key to retrieve from |
Returns:
The stored value, or undefined if the key is not set
getSubDirectory
Gets an IDirectory child of this IDirectory, if it exists.
Signature:
getSubDirectory(subdirName: string): IDirectory | undefined;
Parameters
| Parameter | Type | Description |
|---|---|---|
| subdirName | Name of the child directory to get |
Returns:
The requested IDirectory
getWorkingDirectory
Get an IDirectory within the directory, in order to use relative paths from that location.
Signature:
getWorkingDirectory(relativePath: string): IDirectory | undefined;
Parameters
| Parameter | Type | Description |
|---|---|---|
| relativePath | Path of the IDirectory to get, relative to this IDirectory |
Returns:
The requested IDirectory
hasSubDirectory
Checks whether this directory has a child directory with the given name.
Signature:
hasSubDirectory(subdirName: string): boolean;
Parameters
| Parameter | Type | Description |
|---|---|---|
| subdirName | Name of the child directory to check |
Returns:
True if it exists, false otherwise
set
Sets the value stored at key to the provided value.
Signature:
set<T = any>(key: string, value: T): this;
Parameters
| Parameter | Type | Description |
|---|---|---|
| key | Key to set at | |
| value | Value to set |
Returns:
The IDirectory itself
subdirectories
Gets an iterator over the IDirectory children of this IDirectory.
Signature:
subdirectories(): IterableIterator<[string, IDirectory]>;
Returns:
The IDirectory iterator