Como informar o preenchimento automático do WebStorm sobre o WebGLRenderingContext

Estou trabalhando em um projeto envolvendo o WebGL e usando o WebStorm para fazer o desenvolvimento.

Um problema com o fluxo de desenvolvimento é que o WebStorm não é capaz de completar automaticamente coisas relacionadas ao WebGL. Em particular, se eu anotar um valor como sendo do tipoWebGLRenderingContext

/** @type {!WebGLRenderingContext} */
var gl;

O WebStorm reclama que WebGLRenderingContext é uma variável não resolvida. Também reclama sobre o uso de métodos gl, avisando que não consegue encontrar esses métodos e, portanto, eles podem não existir.

Minha solução atual (além de desativar os avisos) é especificar um tipo de registro como este:

 * @type {{
 *   texParameteri: function,
 *   TEXTURE_WRAP_T: *,
 *   ...
 * }}
 var gl;

Mas, obviamente, é um pouco tolo listar pessoalmente dezenas e dezenas de membros padronizados como esse toda vez que eu quero usar um contexto de renderização. Existe uma maneira mais fácil?

webgl

— Craig Gidney
fonte

Por que é bobo? As coisas que o WebStorm reconhece não são anotadas da mesma maneira? Você deve adicionar suas próprias anotações juntamente com as que acompanham o IDE.

— Ei

@ Hey É bobagem neste caso, porque eu estou fazendo isso de forma ineficiente e redundante. Essas informações já estão disponíveis em algum lugar e com muito mais detalhes (por exemplo, observe que não estou incluindo assinaturas ou documentos por parâmetro). Alguém já fez a listagem, por isso é tolice eu também fazer a listagem.

— Craig Gidney

Então você está realmente perguntando onde encontrar anotações que alguém já escreveu, ou o quê?

— Ei

@ Hey Isso seria aceitável. É assim que funciona para algumas bibliotecas (com anotações na fonte). O fato de o webgl ser incorporado aos navegadores torna um caso um pouco diferente, pois os documentos não têm um local externo natural para morar.

— Craig Gidney

No entanto, eles provavelmente têm um lugar para morar (onde quer que o WebStorm mantenha as anotações para o restante do material interno). O que pode realmente ser útil é converter as anotações IDL para JS. Não sei se existe algo assim.

— Ei

você precisa informar ao WebStorm sobre a API WebGL. Basta ativar a biblioteca WebGL em Configurações | Idiomas e estruturas | JavaScript | Bibliotecas.

Isso criará / modificará o arquivo .idea/jsLibraryMappings.xml

<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="JavaScriptLibraryMappings">
    <includedPredefinedLibrary name="WebGL" />
  </component>
</project>

Consulte: http://blog.jetbrains.com/webstorm/2014/07/how-webstorm-works-completion-for-javascript-libraries/

— Lena
fonte