Come informare il completamento automatico di WebStorm su WebGLRenderingContext

Sto lavorando a un progetto che coinvolge WebGL e sto usando WebStorm per fare lo sviluppo.

Un problema con il flusso di sviluppo è che WebStorm non è in grado di completare automaticamente le cose relative a WebGL. In particolare, se annoto un valore come di tipoWebGLRenderingContext

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

WebStorm lamenta che WebGLRenderingContext è una variabile non risolta. Inoltre si lamenta degli usi dei metodi gl, avvertendo che non riesce a trovare quei metodi, quindi potrebbero non esistere.

La mia attuale soluzione alternativa (oltre a disattivare gli avvisi) è di specificare un tipo di record in questo modo:

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

Ma ovviamente è un po 'sciocco elencare personalmente dozzine e dozzine di membri standardizzati come questo ogni volta che voglio usare un contesto di rendering. C'è un modo più semplice?

webgl

— Craig Gidney
fonte

Perché è sciocco? Le cose che WebStorm riconosce non sono annotate nello stesso modo? Dovresti essere quello di aggiungere le tue annotazioni insieme a quelle fornite con l'IDE.

— Ehi,

@Hey In questo caso è sciocco perché lo sto facendo in modo inefficiente e ridondante. Tali informazioni sono già disponibili da qualche parte, e in modo molto più dettagliato (ad esempio, non includo firme o documenti per parametro). Qualcuno ha già fatto la lista, quindi è sciocco per me fare anche la lista.

— Craig Gidney,

Quindi stai davvero chiedendo dove trovare le annotazioni che qualcun altro ha già scritto o cosa?

— Ehi,

@Hey Sarebbe accettabile. Funziona così per alcune librerie (con le annotazioni presenti nella fonte). Il fatto che webgl sia integrato nei browser lo rende un po 'un caso diverso, in quanto i documenti non hanno un luogo esterno naturale in cui vivere.

— Craig Gidney,

Probabilmente hanno un posto dove vivere, comunque (ovunque WebStorm conservi le annotazioni per il resto delle cose incorporate). Ciò che potrebbe davvero essere utile è una cosa per convertire IDL in annotazioni JS. Non so se esiste qualcosa del genere.

— Ehi,

devi informare WebStorm sull'API WebGL. Abilita la libreria WebGL in Impostazioni | Lingue e quadri | JavaScript | Biblioteche.

Creerà / modificherà il file .idea/jsLibraryMappings.xml

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

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

— Lena
fonte