Skip to main content

@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