Skip to content

jcfieldsdev/history-helper

Repository files navigation

history-helper

A Firefox extension for searching the browser history with a bit better filtering options than the default interface. Written in JavaScript.

History Helper

Installation

This extension can be installed through its Firefox add-on page or from the Chrome Web Store.

Guide

After the extension is installed, a History Helper icon is added to your toolbar. Click this icon to open History Helper.

Search fields

The top part of the interface shows the search fields. You can add new rows by clicking the  +  button. If there is more than one row, you can remove one by clicking its  −  button. You can change the search criteria of the row between Title or URL, Title, URL, Host, Path, or Visit count.

Title or URL, Title, URL, Host, and Path search the history for text using the following comparison operations:

  • Contains
  • Does not contain
  • Starts with
  • Does not start with
  • Ends with
  • Does not end with

The Match case option does case-sensitive string comparisons. The Match whole word option only finds results where the search string is bordered by word boundary characters (such as spaces or hyphens) and not all substring matches. Each text field has a button to clear it.

Visit count filters the history by a numeric value using the following comparison operations:

  • Equal to
  • Not equal to
  • Less than or equal to
  • Less than
  • Greater than or equal to
  • Greater than

Options

Below the search fields are some options.

Date range restricts the search to certain spans of time:

  • Last hour
  • Last day
  • Last week
  • Last month
  • Last year
  • All time

Or you can select Specific range..., which enables the Start date and End date fields for inputting a specific date range. Each date field has a button to reset it.

Sort by changes the order for displaying search results:

  • Title
  • URL
  • Last visited
  • Visit count

By default, Title and URL sorted in ascending order and Last visited and Visit count are sorted in descending order, but toggling the Ascending checkbox reverses the order.

Match chooses whether Any or All search fields must be true for a history entry to match.

Search entries decides how many history entries to search. Smaller values result in less comprehensive search sets, but larger values take longer to complete. This value may be limited by the date range specified; for example, even if 100,000 entries is selected, it may end up searching far fewer than that if the specified date range does not contain that many history entries.

Finally, the Search button starts the search. For performance reasons, the extension does not automatically search the history as you type. It is also necessary to search again to change the sort order of results.

Results

The results are displayed after searching if any have been found. Results are split into multiple pages if there are too many to show on a single page; the number of results to show on each page can be adjusted.

The Last visited date may be outside of the selected search range if the page was visited within the search range and then visited again later. When a page has been visited more than once, a cross icon appears that shows all visits to the page when pressed. Clicking the clock icon next to a date sets the Start date and End date fields to that day.

Acknowledgments

Uses navigation history vector from SVG Repo.

Authors

License