{"meta":{"title":"Запрос ссылочных файлов","intro":"Вы можете использовать файлы ссылок на запросы для определения расположения запроса, который требуется выполнить в тестах.","product":"Безопасность и качество кода","breadcrumbs":[{"href":"/ru/code-security","title":"Безопасность и качество кода"},{"href":"/ru/code-security/concepts","title":"Concepts"},{"href":"/ru/code-security/concepts/code-scanning","title":"Проверка кода"},{"href":"/ru/code-security/concepts/code-scanning/codeql","title":"CodeQL"},{"href":"/ru/code-security/concepts/code-scanning/codeql/query-reference-files","title":"Запрос ссылочных файлов"}],"documentType":"article"},"body":"# Запрос ссылочных файлов\n\nВы можете использовать файлы ссылок на запросы для определения расположения запроса, который требуется выполнить в тестах.\n\n## Сведения о справочных файлах запросов\n\nФайл ссылки на запрос — это текстовый файл, определяющий расположение одного запроса для тестирования.\n\nВы используете файл ссылки на запрос, если вы хотите сообщить `test run` подкомандам выполнить запрос, который не является частью тестового каталога.\nСуществует два способа указать запросы, которые необходимо выполнить в качестве тестов:\n\n1. Используйте файл ссылки на запрос, чтобы указать расположение запроса для тестирования.\n   Это полезно при создании тестов для запросов оповещений и путей, предназначенных для выявления проблем в реальных базах кода. Вы можете создать несколько каталогов тестового кода, каждый из которых фокусируется на различных аспектах запроса. Затем вы добавите файл ссылки на запрос в каждый каталог тестового кода, чтобы указать запрос для тестирования.\n2. Добавьте запрос непосредственно в каталог тестов.\n   Обычно это полезно при написании запросов явным образом для тестирования поведения библиотек QL. Часто эти запросы содержат всего несколько вызовов предикатов библиотеки, упаковав их в `select` инструкцию, чтобы их выходные данные можно было проверить.\n\n## Определение ссылочного файла запроса\n\nКаждый файл `.qlref`ссылки на запрос содержит одну строку, которая определяет, где найти один запрос. Расположение должно быть определено относительно корневого каталога пакета CodeQL, содержащего запрос.\nОбычно это пакет CodeQL, содержащий `.qlref`пакет CodeQL , указанный в `dependencies` блоке для тестового пакета, или транзитивную зависимость пакета CodeQL .\n\nДля обеспечения совместимости между системами следует использовать косую черту в пути ко всем операционным системам.\n\n### Example\n\nФайл ссылки на запрос для тестирования запроса оповещения JavaScript: [DeadAngularJSEventListener.qlref](https://github.com/github/codeql/blob/main/javascript/ql/test/query-tests/AngularJS/DeadAngularJSEventListener/DeadAngularJSEventListener.qlref)\n\nФайл `qlpack.yml` , <https://github.com/github/codeql/blob/main/javascript/ql/test/qlpack.ymlдля> пакета CodeQL определяется `javascript/ql/test``codeql/javascript-queries` как зависимость. Поэтому файл ссылки на запрос определяет расположение запроса относительно `codeql/javascript-queries` пакета CodeQL:\n\n```shell\nAngularJS/DeadAngularJSEventListener.ql\n```\n\nДругой пример см. в разделе [Тестирование пользовательских запросов](/ru/code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/testing-custom-queries)."}