262ea5b06e
* Skip asterisks after newline when parsing JSDoc types * Single boolean expression * Test for parsing and printing multiline function signatures with *
139 lines
2.4 KiB
TypeScript
139 lines
2.4 KiB
TypeScript
// @noEmit: true
|
|
// @allowJs: true
|
|
// @checkJs: true
|
|
|
|
// @Filename: mod1.js
|
|
|
|
/**
|
|
* @typedef {function(string): boolean}
|
|
* Type1
|
|
*/
|
|
|
|
/**
|
|
* Tries to use a type whose name is on a different
|
|
* line than the typedef tag.
|
|
* @param {Type1} func The function to call.
|
|
* @param {string} arg The argument to call it with.
|
|
* @returns {boolean} The return.
|
|
*/
|
|
function callIt(func, arg) {
|
|
return func(arg);
|
|
}
|
|
|
|
// @Filename: mod2.js
|
|
|
|
/**
|
|
* @typedef {{
|
|
* num: number,
|
|
* str: string,
|
|
* boo: boolean
|
|
* }} Type2
|
|
*/
|
|
|
|
/**
|
|
* Makes use of a type with a multiline type expression.
|
|
* @param {Type2} obj The object.
|
|
* @returns {string|number} The return.
|
|
*/
|
|
function check(obj) {
|
|
return obj.boo ? obj.num : obj.str;
|
|
}
|
|
|
|
// @Filename: mod3.js
|
|
|
|
/**
|
|
* A function whose signature is very long.
|
|
*
|
|
* @typedef {function(boolean, string, number):
|
|
* (string|number)} StringOrNumber1
|
|
*/
|
|
|
|
/**
|
|
* Makes use of a function type with a long signature.
|
|
* @param {StringOrNumber1} func The function.
|
|
* @param {boolean} bool The condition.
|
|
* @param {string} str The string.
|
|
* @param {number} num The number.
|
|
* @returns {string|number} The return.
|
|
*/
|
|
function use1(func, bool, str, num) {
|
|
return func(bool, str, num)
|
|
}
|
|
|
|
// @Filename: mod4.js
|
|
|
|
/**
|
|
* A function whose signature is very long.
|
|
*
|
|
* @typedef {function(boolean, string,
|
|
* number):
|
|
* (string|number)} StringOrNumber2
|
|
*/
|
|
|
|
/**
|
|
* Makes use of a function type with a long signature.
|
|
* @param {StringOrNumber2} func The function.
|
|
* @param {boolean} bool The condition.
|
|
* @param {string} str The string.
|
|
* @param {number} num The number.
|
|
* @returns {string|number} The return.
|
|
*/
|
|
function use2(func, bool, str, num) {
|
|
return func(bool, str, num)
|
|
}
|
|
|
|
// @Filename: mod5.js
|
|
|
|
/**
|
|
* @typedef {{
|
|
* num:
|
|
* number,
|
|
* str:
|
|
* string,
|
|
* boo:
|
|
* boolean
|
|
* }} Type5
|
|
*/
|
|
|
|
/**
|
|
* Makes use of a type with a multiline type expression.
|
|
* @param {Type5} obj The object.
|
|
* @returns {string|number} The return.
|
|
*/
|
|
function check5(obj) {
|
|
return obj.boo ? obj.num : obj.str;
|
|
}
|
|
|
|
// @Filename: mod6.js
|
|
|
|
/**
|
|
* @typedef {{
|
|
* foo:
|
|
* *,
|
|
* bar:
|
|
* *
|
|
* }} Type6
|
|
*/
|
|
|
|
/**
|
|
* Makes use of a type with a multiline type expression.
|
|
* @param {Type6} obj The object.
|
|
* @returns {*} The return.
|
|
*/
|
|
function check6(obj) {
|
|
return obj.foo;
|
|
}
|
|
|
|
|
|
// @Filename: mod7.js
|
|
|
|
/**
|
|
Multiline type expressions in comments without leading * are not supported.
|
|
@typedef {{
|
|
foo:
|
|
*,
|
|
bar:
|
|
*
|
|
}} Type7
|
|
*/
|