Что делает /// <reference path = "jquery-1.8.3.js" /"> на самом деле?

Я вижу эту строку кода в некоторых файлах JavaScript, с которыми я работаю, в самом верху файла (первая строка), но мне не совсем ясно, что именно это делает.

Google не сильно помог в этом.

/// <reference path="jquery-1.8.3.js" />

Какова цель этого?

Чтобы добавить больше деталей, я использую Visual Studio 2015.

Ответ 2

Это директива triple-slash для компилятора Typescript. Поскольку tsc будет с удовольствием компилировать JS, это должно работать на любом языке и ссылаться на зависимость.

Директива /// <reference .../> показывает зависимость (для символов компилятора), не обязательно импортируя и фактически загружая файл. Это полезно, когда у вас есть большая библиотека (например, React), которая экспортирует множество интерфейсов или type символов, но вы не хотите фактически включать (поскольку они могут быть проданы во время выполнения). Из документов:

Директива///является наиболее распространенной из этой группы. Он служит объявлением зависимости между файлами.

Ссылки на тройной слэш указывают, что компилятор должен включать дополнительные файлы в процесс компиляции.