Глобальный контекст (Global context)

КаталогДокументовАсинх (DocumentsDirAsync)

Доступен, начиная с версии 8.3.18.

Синтаксис:

КаталогДокументовАсинх()

Возвращаемое значение:

Тип: Обещание.
Результат выполнения обещания - имя каталога, тип Строка.

Для режимов запуска "Тонкий клиент" и "Толстый клиент":

• в MS Windows: <Personal>;
• в Linux: выбирается из надстройки gnome. Если gnome не указан, то метод вернет домашний каталог <Home>.

Для режимов запуска "Веб клиент" (реализуются только в расширении для работы с файлами):

• при использовании веб-браузера Microsoft Internet Explorer: <Personal>;

• при использовании веб-браузера Mozilla Firefox (с помощью XPCOM интерфейса nsIDirectoryServiceProvider):

• в MS Windows: <Personal>;

• в Linux: <Home>;

• в macOS: <Docs> ;

• в OSX: <UsrDocs>.

Для мобильной платформы:

• iOS: Подкаталог \Documents относительно домашней директории приложения. Стандартный каталог, который доступен для обмена файлов в iTunes с помощью функции NSHomeDirectory().
• Android:<Абсолютный путь>, может различаться на разных устройствах. Например:
  • /mnt/sdcard/Android/data/com.e1c.mobile/files/
  • /storage/emulated/0/Android/data/com.e1c.mobile/files/
• Windows:
  • для смартфона: путь внутри домашней директории приложения (C:\Users\<User>\AppData\Local\Packages\<Application>\RoamingState). Каталог не доступен при подключении к ПК. Доступ с ПК можно обеспечить только с помощью утилиты ISETool из комплекта Windows Phone SDK.
  • для планшета: путь внутри домашней директории приложения C:\Data\Users\<User>\DefApps\APPDATA\Local\Packages\ <Application>\RoamingState)

Описание:

Асинхронная функция. Получает стандартный каталог документов.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:

Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с файлами.

См. также:

Глобальный контекст, метод КаталогДокументов
Глобальный контекст, метод НачатьПолучениеКаталогаДокументов

Использование в версии:

Доступен, начиная с версии 8.3.18.

     Методическая информация