hs.axuielement

Таблица общих имён действий объектов доступности, предоставленная для справки.

• эта таблица предоставлена только для справки и не претендует на полноту.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, набрав hs.axuielement.actions

Таблица общих имён атрибутов объектов доступности, которые могут быть использованы с hs.axuielement:elementSearch или hs.axuielement:matchesCriteria в качестве ключей в аргументе критериев сопоставления.

• Эта таблица предоставлена только для справки и не претендует на полноту.
• Вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, набрав hs.axuielement.attributes

Таблица типов ориентации, которые могут быть использованы с hs.axuielement:elementSearch или hs.axuielement:matchesCriteria в качестве значений атрибута "AXOrientation" в аргументе критериев сопоставления.

• эта таблица предоставлена только для справки и может не быть полной.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, набрав hs.axuielement.orientations

Таблица общих имён параметризованных атрибутов объектов доступности, предоставленная для справки.

• эта таблица предоставлена только для справки и не претендует на полноту.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, набрав hs.axuielement.parameterizedAttributes
• Параметризованные атрибуты — это атрибуты, которые принимают аргумент при запросе элемента. Документации по большинству из них очень мало, и разработчики приложений могут реализовывать свои собственные, документации по которым нам может никогда не быть доступно. Эта таблица содержит имена параметризованных атрибутов, определённых в документации Apple, а также некоторые другие, которые были обнаружены.
• Документация, охватывающая обнаруженное путём экспериментов, касательно параметризованных атрибутов, планируется и должна быть добавлена в вики Hammerspoon вскоре после того, как этот модуль станет частью формального выпуска.

Таблица общих ролей объектов доступности, которые можно использовать с hs.axuielement:elementSearch или hs.axuielement:matchesCriteria в качестве значений атрибута «AXRole» в аргументе критериев соответствия.

• эта таблица предоставляется только для справки и не претендует на полноту.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, введя hs.axuielement.roles

Таблица типов маркеров линейки, которые можно использовать с hs.axuielement:elementSearch или hs.axuielement:matchesCriteria в качестве значений атрибута «AXMarkerType» в аргументе критериев соответствия.

• эта таблица предоставляется только для справки и может быть неполной.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, введя hs.axuielement.rulerMarkers

Таблица типов направлений сортировки, которые можно использовать с hs.axuielement:elementSearch или hs.axuielement:matchesCriteria в качестве значений атрибута «AXSortDirection» в аргументе критериев соответствия.

• эта таблица предоставляется только для справки и может быть неполной.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, введя hs.axuielement.sortDirections

Таблица общих подролей объектов доступности, которые можно использовать с hs.axuielement:elementSearch или hs.axuielement:matchesCriteria в качестве значений атрибута «AXSubrole» в аргументе критериев соответствия.

• эта таблица предоставляется только для справки и не претендует на полноту.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, введя hs.axuielement.subroles

Таблица типов единиц измерения, которые можно использовать с hs.axuielement:elementSearch или hs.axuielement:matchesCriteria в качестве значений атрибутов, указывающих типы единиц измерения (например, «AXUnits», «AXHorizontalUnits» и «AXVerticalUnits») в аргументе критериев соответствия.

• эта таблица предоставляется только для справки и может быть неполной.
• вы можете просмотреть содержимое этой таблицы из консоли Hammerspoon, введя hs.axuielement.units

Возвращает функцию для использования с hs.axuielement:elementSearch, которая использует hs.axuielement:matchesCriteria с указанными критериями.

• criteria - определение критериев, как определено для метода hs.axuielement:matchesCriteria.

• функция, которая может быть использована в качестве criteriaFunction для hs.axuielement:elementSearch.

Возвращает верхнеуровневый объект доступности для приложения, указанного объектом hs.application.

• applicationObject - объект hs.application для приложения или строка или число, которые будут переданы hs.application.find, чтобы получить объект hs.application.

• объект axuielement для указанного приложения

• если applicationObject является строкой или числом, только первый найденный элемент с hs.application.find будет использован этой функцией для создания объекта axuielementObject.

Возвращает верхнеуровневый объект доступности для приложения с указанным идентификатором процесса.

• pid - идентификатор процесса приложения.

• объект axuielement для указанного приложения, или nil, если его нельзя определить

Возвращает объект доступности в указанной позиции на экране. Левый верхний угол основного экрана — 0, 0.

• x - координата x экрана для проверки. Если этот параметр указан, то параметр y также должен быть указан, а параметр pointTable не должен быть указан.
• y - координата y экрана для проверки. Этот параметр необходим, если параметр x указан.
• pointTable - координаты x и y позиции на экране, предоставленные как точка-таблица, подобная той, что возвращается hs.mouse.getAbsolutePosition (точка-таблица — это таблица со значениями ключей для ключей x и y). Если этот параметр указан, то отдельные параметры x и y не должны также присутствовать.

• объект axuielement для объекта в указанных координатах, или nil, если объект не был идентифицирован.

• См. также hs.axuielement:elementAtPosition — эта функция является сокращением для hs.axuielement.systemWideElement():elementAtPosition(...).
• Эта функция выполняет проверку нажатия на основе порядка z окон (то есть, слоения). Если одно окно расположено поверх другого окна, возвращаемый объект доступности происходит от окна, которое расположено поверх других в указанном месте.

Возвращает объект доступности, предоставляющий доступ к системным атрибутам.

• Нет

• объект axuielement для системных атрибутов

Возвращает объект доступности для окна, указанного объектом hs.window.

• windowObject - объект hs.window для окна или строка или число, которые будут переданы в hs.window.find для получения объекта hs.window.

• объект axuielementObject для указанного окна

• Если windowObject является строкой или числом, только первый найденный элемент с hs.window.find будет использован этой функцией для создания объекта axuielementObject.

Возвращает локализованное описание действия указанного объекта доступности.

• action - имя действия, как указано в hs.axuielement:actionNames.

• строка, содержащая описание действия объекта, nil, если описание недоступно, или nil и строка с ошибкой, если произошла ошибка доступности

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

Возвращает список всех действий, которые может выполнить указанный объект доступности.

• None

• массив имён всех поддерживаемых действиях axuielementObject или nil и строка с ошибкой, если произошла ошибка доступности

• Общие имена действий можно найти в таблице hs.axuielement.actions; однако этот метод будет отображать только те имена, которые поддерживаются этим объектом, и не ограничивается только теми, которые указаны в таблице.

Возвращает таблицу, содержащую пары «ключ-значение» для всех атрибутов объекта доступности.

• includeErrors - необязательный булево значение, по умолчанию false, указывающее, включать ли в возвращаемые результаты имена атрибутов, которые генерируют ошибку при извлечении.

• таблица с парами «ключ-значение», соответствующими атрибутам объекта доступности, или nil и строка с ошибкой, если произошла ошибка доступности

• Если includeErrors не указан или равен false, то атрибуты, которые существуют для элемента, но в настоящее время не имеют назначенного значения, не будут отображаться в таблице. Это связано с тем, что Lua обрабатывает значение nil для пары «ключ-значение» таблицы как инструкцию по удалению ключа из таблицы, если он в ней в данный момент существует.
• Чтобы включить атрибуты, которые существуют, но в настоящее время не заданы, необходимо указать includeErrors как true.
  • атрибутам, для которых в настоящее время не назначено значения, будет присвоено значение таблицы с парами «ключ-значение»:
    • _code = -25212
    • error = "Запрашиваемое значение не существует"

Запрос объекта доступности для всех дочерних объектов доступности и их потомков.

• callback - обязательная функция, которая должна ожидать два аргумента: строку msg, указывающую, как закончился поиск, и таблицу, содержащую обнаруженные дочерние элементы. msg будет «завершён» при нормальном завершении обхода, и будет содержать строку, начинающуюся с «**», если он завершается преждевременно по какой-либо причине (см. раздел «Примечания» для получения дополнительной информации)
• withParents - необязательный булево значение, по умолчанию false, указывающее, что родитель объектов (и их потомки) должны быть собраны также.

• объект elementSearchObject, как описано в hs.axuielement:elementSearch

• Этот метод является синтаксическим сахаром для hs.axuielement:elementSearch(callback, { [includeParents = withParents] }). Обратитесь к hs.axuielement:elementSearch для получения подробностей о возвращаемом объекте и аргументах обратного вызова.

Если элемент относится к приложению, вернуть объект hs.application для элемента.

• None

• если элемент относится к приложению, вернуть объект hs.application для элемента; в противном случае вернуть nil

• Элемент считается приложением этим методом, если у него есть AXRole AXApplication и идентификатор процесса (pid).

Если элемент относится к окну, вернуть объект hs.window для элемента.

• None

• если элемент относится к окну, вернуть объект hs.window для элемента; в противном случае вернуть nil

• Элемент считается окном этим методом, если у него есть AXRole AXWindow.

Возвращает список всех атрибутов, поддерживаемых указанным объектом доступности.

• None

• массив имён всех поддерживаемых атрибутов axuielementObject или nil и строка с ошибкой, если произошла ошибка доступности

• Общие имена атрибутов можно найти в таблицах hs.axuielement.attributes; однако этот метод будет отображать только те имена, которые поддерживаются этим объектом, и не ограничивается только теми, которые указаны в таблице.

Возвращает значение атрибута объекта доступности.

• attribute - имя атрибута, как указано в hs.axuielement:attributeNames.

• текущее значение атрибута, nil, если у атрибута нет значения, или nil и строка с ошибкой, если произошла ошибка доступности

Возвращает количество элементов массива значения атрибута объекта доступности.

• attribute - имя атрибута, как указано в hs.axuielement:attributeNames.

• количество элементов в значении для атрибута, если это массив, или nil и строка с ошибкой, если произошла ошибка доступности

Захватывает всю доступную информацию об объекте доступности и его потомках и возвращает её в таблице для проверки.

• callback - обязательная функция, которая должна принимать два аргумента: строку msg, указывающую, как закончился поиск, и таблицу, содержащую записанную информацию. msg будет «завершён» при нормальном завершении поиска (или достижении заданной глубины) и будет содержать строку, начинающуюся с «**», если он завершится преждевременно по какой-либо причине (см. раздел «Примечания» для получения дополнительной информации)
• depth - необязательное целое число, значение по умолчанию math.huge, задающее максимальную глубину от исходного объекта доступности, которая должна быть посещена для определения дочерних элементов и их атрибутов.
• withParents - необязательный булевый параметр, значение по умолчанию false, определяющий, нужно ли посещать атрибуты элемента (или потомков) для AXParent и AXTopLevelUIElement при определении дополнительных элементов для включения в таблицу результатов.

• объект elementSearch, как описано в hs.axuielement:elementSearch

• Формат таблицы results, передаваемой в обратный вызов для этого метода, предназначен в первую очередь для отладки и исследовательских целей и может не быть организован для удобной программной обработки.
• Этот метод является синтаксическим сахаром для hs.axuielement:elementSearch(callback, { objectOnly = false, asTree = true, [depth = depth], [includeParents = withParents] }). Обратитесь к hs.axuielement:elementSearch для получения подробностей о возвращаемом объекте и аргументах обратного вызова.

Возвращает таблицу, содержащую только тех непосредственных потомков элемента, которые выполняют указанную роль.

• role - строка, определяющая роль, которую должны выполнять возвращаемые потомки. Примеры значений можно найти в hs.axuielement.roles.

• таблица, содержащая ноль или более axuielementObjects.

• ищут только непосредственные потомки объекта.

Возвращает дубликат ссылки userdata на объект доступности.

• Никаких

• новый объект userdata, представляющий новую ссылку на объект доступности.

Возвращает объект доступности в указанной позиции на экране. Левый верхний угол основного экрана имеет координаты 0, 0.

• x - координата x расположения на экране для проверки. Если этот параметр указан, то параметр y также должен быть указан, а параметр pointTable не должен быть указан.
• y - координата y расположения на экране для проверки. Этот параметр обязателен, если указан параметр x.
• pointTable - координаты x и y расположения на экране, заданные как таблица точек, подобная возвращаемой hs.mouse.getAbsolutePosition (таблица точек — это таблица со значениями для ключей x и y). Если этот параметр указан, то отдельные параметры x и y не должны быть указаны.

• объект axuielementObject для объекта в указанных координатах или nil и строка ошибки, если объект не был идентифицирован или произошла ошибка доступа

• Этот метод может быть вызван только на объекте axuielementObject, который представляет собой приложение или элемент системы (см. hs.axuielement.systemWideElement).
• Этот метод выполняет проверку попадания на основе порядка z окна (то есть, слоёв). Если одно окно расположено поверх другого, возвращаемый объект доступности берётся из того окна, которое находится сверху в указанном расположении.
• Если этот метод вызывается на объекте axuielementObject, представляющем приложение, поиск ограничивается приложением.
• Если этот метод вызывается на объекте axuielementObject, представляющем элемент системы, поиск не ограничивается каким-либо конкретным приложением. См. hs.axuielement.systemElementAtPosition.

Поиск и создание таблицы элементов доступности для атрибутов и потомков этого объекта на основе заданных критериев.

• callback - функция (обычно обязательная), которая получит результаты этого поиска. Обратный вызов должен принимать три аргумента и не возвращать значение. Аргументами функции обратного вызова будут msg, строка, указывающая, как закончился поиск, и results, элементSearchObject, содержащий запрошенные результаты, и количество добавленных элементов в результаты (см. count в namedModifiers). msg будет "completed", если поиск завершился нормально, или строка, начинающаяся с "**", если он был прерван преждевременно (подробнее см. в разделах Returns: и Notes:).
• criteria - необязательная функция, которая должна принимать один аргумент (текущий проверяемый элемент) и возвращать true, если элемент должен быть включен в результаты, или false, если он должен быть исключен. См. hs.axuielement.searchCriteriaFunction для создания функции поиска, использующей hs.axuielement:matchesCriteria для оценки.
• namedModifiers - необязательная таблица, определяющая пары ключ-значение, которые дополнительно изменяют или контролируют поиск. Эта таблица может содержать 0 или более следующих ключей:
  • count - необязательное целое число, по умолчанию math.huge, определяющее максимальное количество совпадений для сбора перед завершением поиска и вызовом обратного вызова. Вы можете продолжить поиск, чтобы найти дополнительные элементы, вызвав elementSearchObject:next() (описано ниже в разделе Returns) на возвращаемом значении этого метода или на аргументе результатов, переданном в обратный вызов.
  • depth - необязательное целое число, по умолчанию math.huge, определяющее максимальное количество шагов (потомков) от исходного элемента доступности, которые поиск должен посетить. Если вы знаете, что ваши искомые элементы находятся относительно близко к исходному элементу, установка этого значения на меньшее значение может значительно ускорить поиск.
  • Ниже перечисленные ключи также распознаются, но могут повлиять на скорость поиска, отзывчивость Hammerspoon или формат результатов таким образом, который ограничивает дальнейшее фильтрование и не рекомендуется, за исключением случаев, когда вам это необходимо: * asTree - необязательный логический параметр, по умолчанию false и игнорируется, если criteria задан и не пуст, objectOnly равен true или count задан. Этот модификатор указывает, должны ли результаты поиска возвращаться как таблица массивов, содержащая подробности каждого элемента (false), или как дерево, в котором подробности корневого узла являются парами ключ-значение возвращаемой таблицы, а подробности дочерних элементов аналогичным образом описываются в подтаблицах, присоединенных к имени атрибута, к которому они относятся (true). Этот формат предназначен в первую очередь для отладки и исследовательских целей и может не быть организован для удобной программной оценки. * includeParents - логический параметр, по умолчанию false, указывающий, следует ли рассматривать родительские атрибуты (AXParent и AXTopLevelUIElement) во время поиска. Обратите внимание, что в большинстве случаев установка этого значения в true приведет к обходу всей структуры доступности для целевого приложения и может значительно замедлить поиск. * noCallback - необязательный логический параметр, по умолчанию false и игнорируется, если callback не nil, позволяющий задать nil в качестве обратного вызова, если он установлен в true. Эта функция требует установки этого именованного аргумента в true и указания поля обратного вызова как nil, поскольку запуск запроса с элемента, имеющего много потомков, **БУДЕТ** блокировать Hammerspoon и замедлять отзывчивость вашего компьютера (в крайних случаях я видел блокировку более 5 минут) и должна использоваться *только* тогда, когда вы знаете, что начинаете с элемента, близкого к концу иерархии элементов. * objectOnly - необязательный логический параметр, по умолчанию true, указывающий, будет ли каждый результат в окончательной таблице элементом доступности, обнаруженным (true), или таблицей, содержащей подробности об элементе, включая имена атрибутов, действия и т. д. для элемента (false). Этот последний формат предназначен в первую очередь для отладки и исследовательских целей и может не быть организован для удобной программной оценки.

• элементSearchObject, который содержит метаметоды, позволяющие проверить, завершился ли процесс, и отменить его досрочно, если это необходимо. Методы включают:
  • elementSearchObject:cancel([reason]) - отменяет текущий поиск и вызывает обратный вызов с частичными результатами, уже собранными. Если вы указали reason, аргумент msg для обратного вызова будет ** <reason>; в противном случае он будет "** cancelled".
  • elementSearchObject:isRunning() - возвращает true, если поиск в настоящее время выполняется, или false, если он завершился или был отменен.
  • elementSearchObject:matched() - возвращает целое число, определяющее количество элементов, которые уже были найдены и соответствуют заданной функции критерия.
  • elementSearchObject:runTime() - возвращает целое число, определяющее количество секунд, потраченных на выполнение этого поиска. Обратите внимание, что это *не* точное измерение того, сколько времени займет каждый поиск, так как время сильно зависит от того, сколько другой активности происходит внутри Hammerspoon и на компьютере пользователя. Возобновление отмененного поиска или поиска, который вызвал обратный вызов, потому что он достиг count элементов с методом next (описанным ниже), приведет к тому, что это число снова начнет увеличиваться, чтобы предоставить кумулятивную сумму времени, потраченного на выполнение поиска; время между вызовом обратного вызова и вызовом метода next не включается.
  • elementSearchObject:visited() - возвращает целое число, определяющее количество элементов, проверенных во время поиска до сих пор.
  • Если asTree имеет значение false или не указано, доступны следующие дополнительные методы:
    • elementSearchObject:filter(criteria, [callback]) -> filterObject
      • возвращает новую таблицу, содержащую элементы в результатах поиска, которые соответствуют заданному критерию.
        • criteria - обязательная функция, которая должна принимать один аргумент (текущий рассматриваемый элемент) и возвращать true, если элемент должен быть включён в результаты, или false, если он должен быть исключён. См. hs.axuielement.searchCriteriaFunction для создания функции поиска, использующей hs.axuielement:matchesCriteria для оценки.
        • callback - необязательный обратный вызов, который должен принимать два аргумента и не возвращать значение. Если обратный вызов указан, обратный вызов получит два аргумента: сообщение о том, как закончился обратный вызов (формат сообщения соответствует стилю, определённому для этого метода), и filterObject, который содержит соответствующие элементы.
      • Возвращаемый filterObject этим методом и переданный в обратный вызов, если он определен, будет поддерживать следующие методы, как определено здесь: cancel, filter, isRunning, matched, runTime, и visited.
    • elementSearchObject:next() - если поиск был отменён или достиг заданного количества совпадений, этот метод продолжит поиск с того места, на котором он остановился. ElementSearchObject, возвращённый при следующем вызове обратного вызова, будет содержать до count добавленных элементов к существующим результатам (вызовы next являются кумулятивными для общих результатов, захваченных в elementSearchObject). Третьим аргументом обратного вызова будет количество элементов, *добавленных* к результатам поиска, а не количество элементов *в* результатах поиска.

• Этот метод использует сопрограммы, чтобы сохранить Hammerspoon отзывчивым, но может быть медленным для завершения, если includeParents имеет значение true, если вы не указали depth, или если вы начинаете поиск с элемента, имеющего много потомков (например, элемента приложения для веб-браузера). Это полностью зависит от того, сколько активных элементов доступности определяет целевое приложение, и от того, с чего вы начинаете свой поиск, и не может быть надёжно определено заранее, поэтому вам может потребоваться экспериментировать, чтобы найти наилучший баланс для ваших конкретных требований.
• Выполняемый поиск является поиском в ширину, поэтому, как правило, элементы в таблице результатов, расположенные раньше, будут «ближе» в иерархии доступности к исходной точке, чем последующие элементы.
• Возвращаемый elementSearchObject этим методом и результаты, переданные в качестве второго аргумента функции обратного вызова, являются одним и тем же объектом — вы можете использовать любой из них в своём коде в зависимости от того, что имеет больше смысла. Результаты, которые соответствуют функции критерия, добавляются в elementSearchObject по мере их обнаружения, поэтому, если вы изучите возвращаемый объектом/таблицей объект и определите, что нашли требуемый элемент или элементы до вызова обратного вызова, вы можете безопасно вызвать метод отмены, чтобы досрочно завершить поиск.
  • Исключением из этого является случай, когда asTree имеет значение true, objectsOnly имеет значение false, а критерии поиска — nil — см. hs.axuielement:buildTree. В этом случае результаты, переданные в обратный вызов, будут равны elementSearchObject[1].
• Если objectsOnly задано как false, может потребоваться некоторое время после вызова cancel для сопоставления таблиц атрибутов элементов с дочерними элементами в наборе результатов — это побочный продукт необходимости перебора результатов для сопоставления всех экземпляров каждого элемента с его таблицей атрибутов.
• hs.axuielement:allDescendantElements — это синтаксический сахар для hs.axuielement:elementSearch(callback, { [includeParents = withParents] })
• hs.axuielement:buildTree — это синтаксический сахар для hs.axuielement:elementSearch(callback, { objectOnly = false, asTree = true, [depth = depth], [includeParents = withParents] })

Возвращает, можно ли изменить заданный атрибут объекта доступности.

• attribute - имя атрибута, как указано в hs.axuielement:attributeNames.

• булево значение, указывающее, можно ли изменить значение параметра, или nil и строка об ошибке, если произошла ошибка доступности

Возвращает, является ли указанный объект доступности по-прежнему допустимым.

• None

• булево значение, указывающее, является ли объект доступности по-прежнему допустимым, или nil и строка об ошибке, если произошла ошибка доступности

• объект доступности может стать недопустимым по различным причинам, включая, но не ограничиваясь, невозможностью доступа к элементу (например, элемент, ссылающийся на окно или одного из его потомков, которое было закрыто) или завершением работы приложения.

Возвращает true, если axuielementObject соответствует заданным критериям, или false, если не соответствует.

• criteria - критерии для сравнения с объектом доступности

• true, если axuielementObject соответствует критериям, false, если не соответствует.

• аргумент criteria должен быть одним из следующих:

  • одиночная строка, определяющая значение атрибута AXRole элемента, которое должно соответствовать для положительного совпадения

  • таблица массивов строк, определяющая список возможных значений атрибута AXRole элемента, которые должны соответствовать для положительного совпадения

  • таблица пар ключ-значение, определяющая более сложные критерии. Таблица должна быть определена следующим образом:

    • должны быть указаны один или несколько из следующих пунктов (хотя все указанные должны совпадать):
      • attribute -- строка или таблица строк, определяющая атрибуты, которые должен поддерживать элемент.
      • action -- строка или таблица строк, определяющая действия, которые элемент должен уметь выполнять.
      • parameterizedAttribute -- строка или таблица строк, определяющая параметризованные атрибуты, которые должен поддерживать элемент.
    • если указан ключ attribute, можно использовать одно из следующих для определения конкретного значения, которому атрибут должен соответствовать для положительного совпадения. Не должно быть более одного из них. Если ни один из них не указан, тогда необходимым условием является только наличие атрибутов, указанных в attribute.
      • value -- значение или таблица значений, которые должен иметь указанный атрибут. Если это таблица, то для положительного совпадения должно соответствовать только одно из значений. Обратите внимание, что если вы указали более одного атрибута с ключом attribute, вам необходимо предоставить хотя бы одно значение для каждого атрибута в этой таблице (порядок не имеет значения, но совпадение завершится неудачей, если какой-либо атрибут не совпадает ни с одним предоставленным значением).
        • при указании значения, которое само по себе является таблицей с ключами (например, frame, size, url, color и т. д.), вы обязаны указать значение или значения в виде таблицы таблиц, например, { { y = 22 } }.
          • только те ключи, которые указаны в значении, проверяются на равенство (или сопоставление с образцом). Значения, которые присутствуют в значении атрибута, но не указаны в значении сравнения, игнорируются (т. е. в предыдущем примере y = 22 будет проверяться только компонент y атрибута AXFrame — значения x, h, и w будут проигнорированы).
          • Для числовых компонентов значений, например, 22 в предыдущем примере, по умолчанию используется сравнение на равенство. Вы можете изменить это с помощью ключа comparison , описанного ниже в необязательных ключах.
          • Для возможных ключей при попытке сопоставить цвет, см. документацию для hs.drawing.color.
          • Для возможных ключей при попытке сопоставить URL, используйте url = <string> и/или filePath = <string>. Строка для указанного ключа таблицы будет сравниваться в соответствии с необязательным ключом pattern , описанным ниже.
        • при указании значения, которое само по себе является таблицей значений (например, список axuielementObjects), вы обязаны указать значение или значения в виде таблицы таблиц, например, { { obj1, obj2 } }.
          • Порядок элементов, предоставленных в значении сравнения, не имеет значения — это проверяет только наличие в значении атрибута.
          • Проверка выполняется только на включение — значение атрибута может содержать и другие элементы, но должно содержать те, которые указаны в значении сравнения.
      • nilValue -- булево значение, указывающее, что атрибуты не должны иметь присвоенного значения (true) или могут иметь любое значение, кроме nil (false). Если указан ключ value, этот ключ игнорируется. Обратите внимание, что это относится ко всем атрибутам, указанным с ключом attribute.
    • следующие являются необязательными ключами и не требуются:
      • pattern -- булево значение, по умолчанию false, указывающее, должны ли совпадения строк для значений атрибутов оцениваться с использованием string.match (true) или как точные совпадения (false). См. руководство по Lua, раздел 6.4.1 (help.lua._man._6_4_1 в консоли Hammerspoon). Если ключ value не задан, этот ключ игнорируется.
      • invert -- булево значение, по умолчанию false, указывающее инвертированную логику для результата критериев — если это true, и критерии соответствуют, оценивать критерии как false; в противном случае оценивать как true.
      • comparison -- строка, по умолчанию "==", указывающая сравнение, используемое при сравнении числовых значений. Возможные строки сравнения: "==" для равенства, "<" для меньше, "<=" для меньше или равно, ">" для больше, ">=" для больше или равно, или "~=" для не равно.

  • массив таблиц по одному или нескольким таблицам ключ-значение, как описано непосредственно выше; элемент должен соответствовать всем таблицам критериев, указанным индивидуально (логическое И).

• Этот метод используется функцией hs.axuielement.searchCriteriaFunction для создания функций критериев, совместимых с hs.axuielement:elementSearch.

Возвращает список всех параметризованных атрибутов, поддерживаемых указанным объектом доступности.

• None

• массив имен всех параметризованных атрибутов, поддерживаемых axuielementObject, или nil и строка об ошибке, если произошла ошибка доступности

Возвращает значение параметризованного атрибута объекта доступности.

• attribute - имя атрибута, как указано в hs.axuielement:parameterizedAttributeNames.
• parameter - параметр, необходимый для параметризованного атрибута.

• текущее значение параметризованного атрибута, nil, если параметризованный атрибут не имеет значения, или nil и строка об ошибке, если произошла ошибка доступности

• Конкретный параметр, необходимый для каждого параметризованного атрибута, отличается и часто зависит от приложения, поэтому требуется некоторое экспериментирование. Сведения о выявленных типах параметров и предположения о некоторых, которые еще исследуются, будут предоставлены в Википедии Hammerspoon, надеюсь, вскоре после того, как этот модуль станет частью выпуска Hammerspoon.

Возвращает таблицу axuielements, отслеживающих это объект через его родительские объекты до корневого объекта для этого элемента, скорее всего, объект приложения или системный объект.

• Никаких

• таблица, содержащая этот объект и 0 или более родительских объектов, представляющих путь от корневого объекта до этого элемента.

• Этот объект всегда будет последним элементом в таблице (например, в позиции table[#table]) с его непосредственным родителем в позиции #table - 1, и так далее, пока не будет достигнут корневой объект для этого элемента в позиции 1.
• Объект axuielement, представляющий приложение или системный объект, является своим собственным корневым объектом и вернет таблицу, содержащую только себя (то есть #table будет равно 1)

Запрашивает, чтобы указанный объект доступности выполнил указанное действие.

• action - имя действия, как указано в hs.axuielement:actionNames.

• если запрошенное действие было принято целевым объектом, возвращает axuielementObject; если запрошенное действие было отклонено, возвращает false; в противном случае возвращает nil и строку ошибки, если произошла ошибка доступности

• Значение возврата только указывает на успех или неудачу, но не гарантирует его. Принимающее приложение может иметь внутреннюю логику, которая предотвращает выполнение действия в данный момент по какой-либо причине, даже если этот метод возвращает успех (axuielementObject). В свою очередь, запрошенное действие может потребовать ответа от пользователя и, следовательно, показаться зависшим, что приведет к тому, что этот метод вернет false или nil.

Возвращает идентификатор процесса, связанный с указанным объектом доступности.

• Никаких

• идентификатор процесса приложения, к которому в конечном итоге принадлежит объект доступности, или nil и строка ошибки, если произошла ошибка доступности

Устанавливает атрибут объекта доступности в указанное значение.

• attribute - имя атрибута, как указано в hs.axuielement:attributeNames.
• value - значение, которое нужно назначить атрибуту

• объект axuielement при успехе; nil и строка ошибки, если атрибут не может быть установлен или произошла ошибка доступности.

Устанавливает значение таймаута, используемое при запросах доступности, выполненных из этого элемента.

• value - количество секунд для нового значения таймаута. Должно быть 0 или положительным.

• объект axuielement или nil и строка ошибки, если произошла ошибка доступности

• Чтобы изменить глобальный таймаут, влияющий на все запросы к элементам, у которых нет заданного таймаута, используйте этот метод для системного элемента (см. hs.axuielement.systemWideElement.
• Изменение значения таймаута для объекта axuielement изменяет значение только для этого конкретного элемента — другие объекты axuielement, которые могут ссылаться на тот же элемент доступности, не затрагиваются.
• Установка значения в 0.0 сбрасывает таймаут — если применён к системному объекту systemWideElement, глобальное значение по умолчанию будет сброшено до значения по умолчанию; если применён к другому объекту axuielement, таймаут будет сброшен до текущего глобального значения, применённого к системному элементу.