@see
Standardization: | Extended |
Syntax kind: | Block tag |
Usageโ
Used to build a list of references to an API item or other resource that may be related to the current item.
Note: JSDoc attempts to automatically hyperlink the text immediately after
@see
. Because this is ambiguous with plain text, TSDoc instead requires an explicit{@link}
tag to make hyperlinks.
Exampleโ
/**
* Parses a string containing a Uniform Resource Locator (URL).
*
* @param url - The string to be parsed
*
* @returns The parsed result
*
* @see {@link ParsedUrl} for the returned data structure
* @see {@link https://tools.ietf.org/html/rfc1738|RFC 1738}
* for syntax
* @see your developer SDK for code samples
*/
function parseURL(url: string): ParsedUrl;
@see
is a block tag. Each block becomes an item in the list of references. For example, a documentation
system might render the above blocks as follows:
`function parseURL(url: string): ParsedUrl;`
Parses a string containing a Uniform Resource Locator (URL).
## See Also
- ParsedUrl for the returned data structure
- RFC 1738 for syntax
- your developer SDK for code samples
See alsoโ
- RFC #235:
@see
block tag specifies an item for a "See Also" section