Cách thông báo tự động hoàn tất của WebStorm về WebGLRenderingContext

Tôi đang làm việc trên một dự án liên quan đến WebGL và sử dụng WebStorm để thực hiện phát triển.

Một vấn đề với dòng phát triển là WebStorm không thể tự động hoàn thành những thứ liên quan đến WebGL. Cụ thể, nếu tôi chú thích một giá trị là loạiWebGLRenderingContext

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

WebStorm phàn nàn rằng WebGLRenderingContext là một biến chưa được giải quyết. Ngoài ra, nó phàn nàn về việc sử dụng các phương thức trên gl, cảnh báo rằng nó không thể tìm thấy các phương thức đó để chúng không tồn tại.

Cách giải quyết hiện tại của tôi (ngoài việc tắt các cảnh báo) là chỉ định loại bản ghi như vậy:

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

Nhưng rõ ràng là hơi ngớ ngẩn khi đích thân liệt kê hàng chục và hàng chục thành viên được tiêu chuẩn hóa như thế này mỗi khi tôi muốn sử dụng bối cảnh kết xuất. Có cách nào dễ hơn không?

webgl

— Craig Gidney
nguồn

Tại sao nó ngớ ngẩn? Không phải những thứ WebStorm nhận ra được chú thích theo cùng một cách sao? Bạn nên thêm các chú thích của riêng bạn cùng với các chú thích đi kèm với IDE.

— Này

@Hey Thật ngớ ngẩn trong trường hợp này bởi vì tôi đang làm nó không hiệu quả và dư thừa. Thông tin đó đã được đưa ra ở đâu đó và chi tiết hơn rất nhiều (ví dụ: thông báo tôi không bao gồm chữ ký hoặc tài liệu theo tham số). Ai đó đã thực hiện việc niêm yết, vì vậy thật ngớ ngẩn khi tôi cũng thực hiện việc niêm yết.

— Craig Gidney

Vì vậy, bạn thực sự hỏi nơi để tìm chú thích mà người khác đã viết, hoặc những gì?

— Này

@Hey Điều đó sẽ được chấp nhận. Đó là cách nó hoạt động đối với một số thư viện (với các chú thích nằm trong nguồn). Việc webgl được tích hợp sẵn cho các trình duyệt khiến nó trở thành một trường hợp khác, trong đó các tài liệu không có nơi ở tự nhiên bên ngoài để sinh sống.

— Craig Gidney

Họ có thể có một nơi để sống, mặc dù (bất cứ nơi nào WebStorm giữ các chú thích cho phần còn lại của các công cụ tích hợp). Điều có thể thực sự hữu ích là một điều để chuyển đổi các chú thích IDL sang JS. Tôi không biết nếu có bất cứ điều gì như thế tồn tại.

— Này

bạn cần cho WebStorm biết về API WebGL. Chỉ cần kích hoạt thư viện WebGL trong Cài đặt | Ngôn ngữ & Khung | JavaScript | Thư viện.

Nó sẽ tạo / sửa đổi tập tin .idea/jsLibraryMappings.xml

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

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

— lena
nguồn