Файловая система

У каждой песочницы есть изолированная файловая система. Используйте sandbox.files, чтобы обмениваться данными с песочницей без составления команд оболочки.

SDK позволяет:

• читать и записывать файлы;
• получать сведения о файлах и каталогах;
• хранить метаданные файлов;
• следить за изменениями каталога;
• загружать локальные данные;
• скачивать данные из песочницы.

Пути вычисляются внутри песочницы. В прикладном коде лучше использовать абсолютные пути, чтобы результат не зависел от рабочего каталога.

Файловая система существует, пока существует песочница. Чтобы сохранить данные между запусками, используйте паузу или снапшоты.

Все методы JavaScript, синхронные и асинхронные классы Python, а также Go API перечислены в справочнике SDK.

Пользователь и опции Go

Файловая опция user выбирает домашний каталог для вычисления путей вроде ~ и владельца создаваемых объектов. Она не изолирует файловые RPC по правам пользователей ОС. Пример работы с домашним каталогом выбранного пользователя приведён в руководстве по чтению и записи.

В Go все файловые методы принимают указатель на опции последним аргументом. Передайте nil для значений по умолчанию. Используйте FileOptions.User для чтения и простых файловых операций, ListFilesOptions для списка файлов, WriteFileOptions для загрузки и пакетной записи, WatchOptions для наблюдения и FileURLOptions для подписанных URL.

Глубину списка задаёт ListFilesOptions.Depth, а срок действия подписанного URL — FileURLOptions.Expiration. В ReadTo приёмник данных передаётся перед опциями.

Сигнатуры методов приведены в файловом API Go.