зеркало из https://github.com/mozilla/gecko-dev.git
80 строки
3.0 KiB
Plaintext
80 строки
3.0 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*/
|
|
|
|
interface File;
|
|
|
|
/*
|
|
* All functions on Directory that accept DOMString arguments for file or
|
|
* directory names only allow relative path to current directory itself. The
|
|
* path should be a descendent path like "path/to/file.txt" and not contain a
|
|
* segment of ".." or ".". So the paths aren't allowed to walk up the directory
|
|
* tree. For example, paths like "../foo", "..", "/foo/bar" or "foo/../bar" are
|
|
* not allowed.
|
|
*/
|
|
[NoInterfaceObject]
|
|
interface Directory {
|
|
/*
|
|
* The leaf name of the directory.
|
|
*/
|
|
readonly attribute DOMString name;
|
|
|
|
/*
|
|
* Creates a descendent directory. This method will create any intermediate
|
|
* directories specified by the path segments.
|
|
*
|
|
* @param path The relative path of the new directory to current directory.
|
|
* If path exists, createDirectory must fail.
|
|
* @return If succeeds, the promise is resolved with the new created
|
|
* Directory object. Otherwise, rejected with a DOM error.
|
|
*/
|
|
[NewObject]
|
|
// Promise<Directory>
|
|
Promise createDirectory(DOMString path);
|
|
|
|
/*
|
|
* Gets a descendent file or directory with the given path.
|
|
*
|
|
* @param path The descendent entry's relative path to current directory.
|
|
* @return If the path exists and no error occurs, the promise is resolved
|
|
* with a File or Directory object, depending on the entry's type. Otherwise,
|
|
* rejected with a DOM error.
|
|
*/
|
|
[NewObject]
|
|
// Promise<(File or Directory)>
|
|
Promise get(DOMString path);
|
|
|
|
/*
|
|
* Deletes a file or an empty directory. The target must be a descendent of
|
|
* current directory.
|
|
* @param path If a DOM string is passed, it is the relative path of the
|
|
* target. Otherwise, the File or Directory object of the target should be
|
|
* passed.
|
|
* @return If the target is a non-empty directory, or if deleting the target
|
|
* fails, the promise is rejected with a DOM error. If the target did not
|
|
* exist, the promise is resolved with boolean false. If the target did exist
|
|
* and was successfully deleted, the promise is resolved with boolean true.
|
|
*/
|
|
[NewObject]
|
|
// Promise<boolean>
|
|
Promise remove((DOMString or File or Directory) path);
|
|
|
|
/*
|
|
* Deletes a file or a directory recursively. The target should be a
|
|
* descendent of current directory.
|
|
* @param path If a DOM string is passed, it is the relative path of the
|
|
* target. Otherwise, the File or Directory object of the target should be
|
|
* passed.
|
|
* @return If the target exists, but deleting the target fails, the promise is
|
|
* rejected with a DOM error. If the target did not exist, the promise is
|
|
* resolved with boolean false. If the target did exist and was successfully
|
|
* deleted, the promise is resolved with boolean true.
|
|
*/
|
|
[NewObject]
|
|
// Promise<boolean>
|
|
Promise removeDeep((DOMString or File or Directory) path);
|
|
};
|
|
|