hs.spotlight.item

Этот подмодуль используется для доступа к отдельным результатам spotlightObject или spotlightGroupObject.

Каждый элемент Spotlight содержит атрибуты, к которым можно получить доступ с помощью метода hs.spotlight.item:valueForAttribute. Массив, содержащий общие атрибуты для типа сущности, которую представляет элемент, можно получить с помощью метода hs.spotlight.item:attributes, однако этот список атрибутов обычно не является полным списком доступных атрибутов для данного spotlightItemObject. Многие известные имена атрибутов включены в постоянный массив hs.spotlight.commonAttributeKeys, но даже это не является исчерпывающим списком — приложение может создавать и назначать любой ключ, который оно пожелает, для включения в базу данных метаданных Spotlight.

Для удобства к spotlightItemObjects были добавлены метаметоды в качестве сокращения для метода hs.spotlight.item:valueForAttribute; например, вы можете получить значение определенного атрибута, используя имя атрибута в качестве имени ключа: spotlightItemObject.kMDItemPath вернет путь к сущности, на которую ссылается spotlightItemObject.

Обзор API

Методы - вызовы API, которые могут быть выполнены только на объекте, возвращенном конструктором

attributes
valueForAttribute

Документация API

Методы

attributes

Подпись	`hs.spotlight.item:attributes() -> table`
Тип	Метод
Описание	Возвращает список атрибутов, связанных с spotlightItemObject
Параметры	Нет
Возвращает	таблица массива, содержащая список атрибутов, связанных с элементом результата.
Примечания	Этот список атрибутов обычно не является полным списком доступных атрибутов для данного spotlightItemObject. Многие известные имена атрибутов включены в постоянный массив `hs.spotlight.commonAttributeKeys`, но даже это не является исчерпывающим списком — приложение может создавать и назначать любой ключ, который оно пожелает, для включения в базу данных метаданных Spotlight. Общий атрибут, который обычно не включен в результаты этого метода, — это атрибут "kMDItemPath", который указывает локальный путь к файлу, который представляет сущность. Он включен для справки, так как это часто необходимое значение, которое не очевидно доступно для почти всех записей Spotlight. Считается, что только те ключи, которые явно установлены при добавлении элемента в базу данных Spotlight, включены в возвращаемый массив. Любой атрибут, который вычисляется или ограничен в защищенном приложении, по-видимому, требует явного запроса. Однако это предположение, и при необходимости вы должны явно проверять требуемые атрибуты с помощью hs.spotlight.item:valueForAttribute, а не полагаться только на результаты этого метода.
Источник	extensions/spotlight/libspotlight.m строка 797

valueForAttribute

Подпись	`hs.spotlight.item:valueForAttribute(attribute) -> value`
Тип	Метод
Описание	Возвращает значение указанного атрибута spotlightItemObject
Параметры	`attribute` - строка, определяющая атрибут, значение которого нужно получить для spotlightItemObject
Возвращает	значение атрибута в качестве соответствующего типа данных или nil, если атрибут не существует или не содержит значения
Примечания	См. hs.spotlight.item:attributes для получения информации о возможных именах атрибутов. Для удобства к spotlightItemObject были добавлены метаметоды, которые позволяют использовать `spotlightItemObject.attribute` в качестве сокращения для `spotlightItemObject:valueForAttribute(attribute)`.
Источник	extensions/spotlight/libspotlight.m строка 821

© 2014–2017 Hammerspoon contributors
Licensed under the MIT License.
https://www.hammerspoon.org/docs/hs.spotlight.item.html