Как правильно описать переменную в Javascript в PhpStorm?

Question

[Дмитрий Ким]

Раньше было все равно, а сейчас решил заморочиться. Допустим мы используем яндекс.карты, вставляем вызов скрипта карт

<script src="//api-maps.yandex.ru/2.1/?lang=ru_RU" type="text/javascript"></script>

, затем рядом пишем свой скрипт:

<script type="text/javascript">
$(function () {
  ymaps.ready(function () {
    // ......
  });
});

IDE ругается на то, что не может определить "кто такой ymaps".
В php можно просто написать /* @var Array $ymaps */, например, а как дело обстоит в Javascript?

Answer 1

[Павел Гришин]

а window.ymaps.ready(function (){}) разве не сработает?

Comments

[Дмитрий Ким]

Вопрос не в том, что код не работает. А в том, что IDE подчеркивает ymaps как "что-то неизвестное ей".

Answer 2

[Денис Инешин]

По идее примерно так же. Можно создать рядом reference.js файл (не включенный в сборку) или что-то в этом духе, и разместить там эту переменную. Либо, в настройках проекта, добавить эту переменную как глобальную.

Answer 3

[Fetur]

Толкового решения нет, загружая с api-maps.yandex.ru, вы загружаете все лишь загрузчик модулей, которые, если будут использованы, будут подтягиваться. Смиритесь.

Как загрузить либу прямо из IDE
Аналогичный вопрос на тостере
Куски библиотеки API карт

Answer 4

[Константин Китманов]

PHPStorm понимает JSDoc.

Comments

[Дмитрий Ким]

Ну так что мне нужно написать в коде, чтобы ymaps стал понятной переменной для IDE?

[Константин Китманов]

Дмитрий Ким: если хотите интеллисенс, то придется написать большую простыню. А просто чтобы идешка не ругалась, то что-то вроде такого:

/**
 * @type {Object}
 * @name ymaps
 */

В любом месте.

[Дмитрий Ким]

Не помогает. Все понятно в общем, спасибо.

[Константин Китманов]

Дмитрий Ким: я у себя написал — помогло:) PHPStorm отстает в поддержке JS, возможно, дело в этом.