---
name: "WWW::Mechanize::Link"
section: "3pm"
platform: "linux"
package: "perl-www-mechanize"
version: "2.22-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/WWW::Mechanize::Link"
---

# WWW::Mechanize::Link(3pm)

Link object for WWW::Mechanize

## NAME

WWW::Mechanize::Link - Link object for WWW::Mechanize

## VERSION

version 2.22

## SYNOPSIS

Link object to encapsulate all the stuff that Mech needs but nobody wants to deal with as an array.

## Constructor

### new()

```
    my $link = WWW::Mechanize::Link->new( {
        url  => $url,
        text => $text,
        name => $name,
        tag  => $tag,
        base => $base,
        attr => $attr_href,
    } );
```

For compatibility, this older interface is also supported:

```
 new( $url, $text, $name, $tag, $base, $attr_href )
```

Creates and returns a new `"WWW::Mechanize::Link"` object.

## Accessors

### $link-\>url()

URL from the link

### $link-\>text()

Text of the link

### $link-\>name()

NAME attribute from the source tag, if any.

### $link-\>tag()

Tag name (one of: "a", "area", "frame", "iframe" or "meta").

### $link-\>base()

Base URL to which the links are relative.

### $link-\>attrs()

Returns hash ref of all the attributes and attribute values in the tag.

### $link-\>URI()

Returns the URL as a URI::URL object.

### $link-\>url\_abs()

Returns a URI::URL object for the absolute form of the string.

## SEE ALSO

WWW::Mechanize and WWW::Mechanize::Image

## AUTHOR

Andy Lester \<andy at petdance.com\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2004 by Andy Lester.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.