Skip to main content
Sends an input focus event to Constructor.io’s API. This tracks when a user clicks or focuses on a search input field, indicating intent to search.

Method Signature

constructorio.tracker.trackInputFocus(networkParameters?)

Parameters

networkParameters
object
Optional parameters for the network request

Returns

Returns true on success or an Error object if the tracking call fails validation.

Example

import ConstructorIOClient from '@constructor-io/constructorio-client-javascript';

const constructorio = new ConstructorIOClient({
  apiKey: 'YOUR_API_KEY',
});

// Track input focus
constructorio.tracker.trackInputFocus();

Integration Example

// Add event listener to search input
const searchInput = document.querySelector('#search-input');

searchInput.addEventListener('focus', () => {
  constructorio.tracker.trackInputFocus();
});

Example with Network Parameters

// Track input focus with custom timeout
constructorio.tracker.trackInputFocus({
  timeout: 5000,
});

When to Use

Call trackInputFocus() when:
  • A user clicks on a search input field
  • A user focuses on a search input field via keyboard navigation
  • A search input becomes active

Why Track Input Focus?

Tracking input focus helps Constructor.io understand:
  • User search intent and engagement
  • How often users interact with search functionality
  • Search abandonment rates (focus without submission)
  • A/B test performance for search UI elements

API Endpoint

This method sends a GET request to:
/behavior?action=focus

Build docs developers (and LLMs) love