What's the condition for DocumentLink target to be undefined?

[usernamehw]

I would like to use api to get links from the document:

const links = await vscode.commands.executeCommand<DocumentLink[]>('vscode.executeLinkProvider', document.uri);

DocumentLink is guaranteed to have a range: Range;, but not the target?: Uri;. What are the cases when target is undefined, or am I using the wrong type?

[usernamehw]

vscode/src/vs/vscode.d.ts

Lines 4030 to 4058 in 62f1bf8

	export class DocumentLink {
	/**
	* The range this link applies to.
	*/
	range: Range;
	/**
	* The uri this link points to.
	*/
	target?: Uri;
	/**
	* The tooltip text when you hover over this link.
	*
	* If a tooltip is provided, is will be displayed in a string that includes instructions on how to
	* trigger the link, such as `{0} (ctrl + click)`. The specific instructions vary depending on OS,
	* user settings, and localization.
	*/
	tooltip?: string;
	/**
	* Creates a new document link.
	*
	* @param range The range the document link applies to. Must not be empty.
	* @param target The uri the document link points to.
	*/
	constructor(range: Range, target?: Uri);
	}

[jrieken]

Links without target must be resolved, see

vscode/src/vs/vscode.d.ts

Line 4086 in ab4892d

resolveDocumentLink?(link: T, token: CancellationToken): ProviderResult<T>;

. The command seems to not resolve them.

[github-actions]

This bug has been fixed in to the latest release of VS Code Insiders!

@usernamehw, you can help us out by confirming things are working as expected in the latest Insiders release. If things look good, please leave a comment with the text /verified to let us know. If not, please ensure you're on version 9e50567 of Insiders (today's or later - you can use Help: About in the command pallete to check), and leave a comment letting us know what isn't working as expected.

Happy Coding!