Function extractLinks

extractLinks(
    doc: Document,
    baseUrl?: string | URL | null,
    options?: LinksExtractionOptions,
): LinksMetadata
Extract links from parsed HTML document.
Parameters
- doc: Document
  Parsed HTML document
- OptionalbaseUrl: string | URL | null
  Base URL for resolving relative links and determining internal/external
- options: LinksExtractionOptions = {}
  Extraction options for filtering and categorization
Returns LinksMetadata
Links metadata with categorized links
Remarks
Extracts all <a href> links with comprehensive metadata and filtering options. Perfect for crawlers, SEO analysis, and link discovery.

Features:
- Internal/external link categorization
- Rel attribute filtering (nofollow, ugc, sponsored, etc.)
- Automatic URL normalization
- Hash link filtering
- Scheme filtering (only http/https)
- Deduplication
- Link text extraction
Example
```
const doc = parseHTML(htmlString);
const links = extractLinks(doc, 'https://example.com');

// Get all internal links (same origin)
console.log(links.internal);

// Get external links excluding nofollow
const linksNoFollow = extractLinks(doc, 'https://example.com', {
  scope: 'external',
  excludeRel: ['nofollow']
});
```
Example
```
// Crawler use case - get follow-able links
const links = extractLinks(doc, baseUrl, {
  excludeRel: ['nofollow', 'ugc', 'sponsored'],
  includeHashLinks: false
});
```
- Defined in src/metadata/links/extract.ts:66