使用變量定義JSDoc類型[WebStorm友好]

Question

在下面的代碼中，我想使用testSettings變量定義ApplicationSettings類型的形狀，以便在useSettings函數內部可以知道在settings對象上可以訪問哪些屬性：

/** @typedef ApplicationSettings */
var testSettings = {
    apiService: {},
    configuration: {}
};

/**
 * @param {ApplicationSettings} settings
 */
function useSettings(settings) {
    console.log(settings.apiService); // apiService is not recognized here
    console.log(settings.configuration); // same for configuration
}

不幸的是，在這種情況下， @typedef似乎不是有效的注釋。 是否可以告訴WebStorm，而無需在JSDoc中顯式指定其所有屬性， ApplicationSettings類型應該是什么樣？

Answer 1

為什么在這里需要@typedef？ 以下語法有效：

var testSettings = {
    apiService: {},
    configuration: {}
};

/**
 * @param {testSettings} settings
 */
function useSettings(settings) {
    console.log(settings.apiService); 
    console.log(settings.configuration);