Create a JavaScript document extractor with GLOB URL matching

Create a JavaScript document extractor when you want to use a JavaScript function to extract attribute values. Use this method in complex scenarios where an XPath expression will not suffice.

Note

You can use a JavaScript document extractor with the advanced web crawler and the API crawler sources.

To use JavaScript to extract attribute values from URLs that match the condition of a specific GLOB pattern:

Log in to the Customer Engagement Console (CEC), click Sources , and select the source you created.
On the Source Settings page, next to Document Extractors, click edit ( ).
To create a document extractor, on the Document Extractors page:
- In the Name field, enter a meaningful name for the extractor.
  
  For example, enter Home loans JS extractor.
- In the Extractor Type drop-down menu, click JS.
- Optionally, to ensure that this extractor's logic only applies to URLs that match a certain pattern, configure URLs to Match. To do this, in the URLs To Match field, click Add Matcher, select the TYPE of expression you want to use, and enter the VALUE of that expression.
  
  For example, to crawl all URLs in this format: <some text>/homeloans/<some text>, you can click Glob Expression in the TYPE drop-down menu and enter the VALUE as **/homeloans/**.* .
In the Taggers section, click Edit next to the first tag. Usually, it is the content tag.

In the tag editor, you see a sample JavaScript function that returns the description, name, type, image_url and url attributes. Search provides this sample to help with configuration.

Note

Within a document extractor, you can create multiple taggers, each linked to a unique tag. Each tagger generates a set of index documents. Taggers have rules, each of which defines the extraction logic of one attribute.

For example, if you have one tagger with a JavaScript function that defines how to extract five attributes, you get one set of index documents where each document has five attributes. However, if you have three taggers, and each has a JavaScript function that defines how to extract one, you get three sets of index documents where each document has one attribute.

In the tag editor, edit the sample function or paste a new JavaScript function that returns attribute values.

Note

The function must use Cheerio syntax and must return an array of objects.

For example, paste:

RequestResponseshell

function extract(request, response) {
  $ = response.body;
  curr_url = request.url;

  let url = request.url;
  let type, subtype;
  type = 'homes';

  if (url.includes('/moving/')) {
    subtype = 'Moving';
  } else if (url.includes('/plans-products/')) {
    subtype = 'Plans and products';
  } else if (url.includes('/partnerships/')) {
    subtype = 'Partnerships';
  } else if (url.includes('/referrals/')) {
    subtype = 'Referrals';
  } else {
    subtype = 'misc';
  }

  let name, subtitle, description, image, date, year;

  name = $('h1[class="main-title"]').text() !== null ? $('h1[class="main-title"]').text().replace(/\s\s+/g, ' ').trim() : '';
  subtitle = $('h2[class="htmlSubtitle"]').text() !== null ? $('h2[class="htmlSubtitle"]').text().replace(/\s\s+/g, ' ').trim() : '';
  description = $('div[class="bodycopy"]').text() !== null ? $('div[class="bodycopy"]').text().replace(/\s\s+/g, ' ').trim() : '';
  image = $('div[class="hero-img"]').find('img').attr('src') !== null ? 'https://www.txu.com' + $('div[class="hero-img"]').find('img').attr('src') : '';

  return [{
    'name': name,
    'subtitle': subtitle,
    'description': description,
    'image_url': image,
    'type': type,
    'subtype': subtype,
    'url': url
  }];
}

This function uses the following logic to get attributes:

type - use a fixed value, for example, homes.
subtype - variable that can take one of five values depending on the URL path.
url - get this from the request.url.
name - if the text from the <h1 class="main-title"> tag has a value, use a modified form of that text as the Name. If it is empty, use an empty string for Name.
subtitle - if the text from the <h2 class="htmlSubtitle"> tag has a value, use a modified form of that text as the Name. If it is empty, use an empty string for Name.
description - if the text from the <bodycopy><div> class has a value, use a modified form of that text as the Description. If it is empty, use an empty string for Description.
image_url - if the img src attribute of the hero-imgdiv class has a value, use a modified form of that URL. If it is empty, use an empty string for Image_url.

In the tag editor, click Save.
Optionally, to extract attributes for another tag, click Add Tagger, and in the Tag drop-down menu, click a tag and repeat Steps 5 and 6.
Oon the Document Extractors page, click Save.

Do you have some feedback for us?

If you have suggestions for improving this article,