Get Attributes

​

Overview

• Extracting attributes from DOM elements
• Using CSS selectors to target elements
• Extracting multiple attributes at once
• Filtering elements by various criteria
• Returning structured attribute data

​

Parameters

​

Element Locator Configuration

{
  "elementsLocator": {
    "selector": "a.article-link",
    "timeout": 10000
  }
}

​

Locator Properties

​

Usage Examples

​

Extract Link Attributes

{
  "command": "GetAttributes",
  "params": {
    "elementsLocator": {
      "selector": "a.article-link",
      "timeout": 10000
    },
    "attributes": ["href", "title"],
    "key": "article_links"
  }
}

​

Extract Image Attributes

{
  "command": "GetAttributes",
  "params": {
    "elementsLocator": {
      "selector": "img.article-image",
      "timeout": 10000
    },
    "attributes": ["src", "alt", "width", "height"],
    "key": "article_images"
  }
}

​

Extract Data Attributes

{
  "command": "GetAttributes",
  "params": {
    "elementsLocator": {
      "selector": "[data-item]",
      "timeout": 10000
    },
    "attributes": ["data-item-id", "data-item-type", "data-item-value"],
    "key": "item_data"
  }
}

​

Extract with Session

{
  "command": "GetAttributes",
  "params": {
    "sessionId": "#{UUID}",
    "elementsLocator": {
      "selector": "a.link",
      "timeout": 10000
    },
    "attributes": ["href", "title", "class"],
    "key": "links"
  }
}

​

Common Attributes

​

Link Attributes

• href: Link destination URL
• title: Link title/tooltip
• target: Link target (_blank, _self, etc.)
• rel: Link relationship

​

Image Attributes

• src: Image source URL
• alt: Alternative text
• width: Image width
• height: Image height
• title: Image title

​

Data Attributes

• data-*: Custom data attributes
• id: Element ID
• class: Element classes
• aria-*: Accessibility attributes

​

Output Structure

​

Single Element

{
  "article_link": {
    "href": "https://example.com/article",
    "title": "Article Title"
  }
}

​

Multiple Elements

{
  "article_links": [
    {
      "href": "https://example.com/article1",
      "title": "Article 1"
    },
    {
      "href": "https://example.com/article2",
      "title": "Article 2"
    }
  ]
}

​

Variable Support

• Selector: Use variables in CSS selectors
• Session ID: Use #{UUID} for session tracking

​

Best Practices

• Use Stable Selectors: Prefer class names and IDs over text-based selectors
• Set Appropriate Timeouts: Configure timeouts for dynamic content loading
• Extract Relevant Attributes: Only extract attributes you need
• Handle Missing Attributes: Account for cases where attributes don’t exist
• Use Descriptive Keys: Use clear, descriptive key names for extracted attributes

​

Common Use Cases

• Link Extraction: Extract links from pages
• Image Extraction: Extract image sources and metadata
• Data Attribute Extraction: Extract custom data attributes
• Metadata Extraction: Extract element metadata

​

Related Commands

• Browser Open - Open browser before extraction
• Get Text Contents - Extract text instead of attributes
• HTTP Request - Fetch resources from extracted URLs