33ab953 Apr 27, 2015
@jharding @timtrueman @pborreli
250 lines (202 sloc) 11.3 KB


For transparency and insight into our release cycle, releases will be numbered with the follow format:


And constructed with the following guidelines:

  • Breaking backwards compatibility bumps the major
  • New additions without breaking backwards compatibility bumps the minor
  • Bug fixes and misc changes bump the patch

For more information on semantic versioning, please visit

0.11.1 April 26, 2015

  • Add prepare option to prefetch. #1181
  • Handle QuotaExceededError. #1110
  • Escape HTML entities from suggestion display value when rendering with default template. #964
  • List jquery as a dependency in package.json. #1143

0.11.0 April 25, 2015

An overhaul of typeahead.js – consider this a release candidate for v1. There are bunch of API changes with this release so don't expect backwards compatibility with previous versions. There are also many new undocumented features that have been introduced. Documentation for those features will be added before v1 ships.

Beware that since this release is pretty much a rewrite, there are bound to be some bugs. To be safe, you should consider this release beta software and throughly test your integration of it before using it in production environments. This caveat only applies to this release as subsequent releases will address any issues that come up.

0.10.5 August 7, 2014

  • Increase supported version range for jQuery dependency. #917

0.10.4 July 13, 2014


  • Fix regression that breaks Bloodhound instances when more than 1 instance is relying on remote data. #899

0.10.3 July 10, 2014

Bug fixes

  • Bloodhound#clearPrefetchCache now works with cache keys that contain regex characters. #771
  • Prevent outdated network requests from being sent. #809
  • Add support to object tokenizers for multiple property tokenization. #811
  • Fix broken jQuery#typeahead('val') method. #815
  • Remove disabled attribute from the hint input control. #839
  • Add tt-highlight class to highlighted text. #833
  • Handle non-string types that are passed to jQuery#typeahead('val', val). #881

0.10.2 March 10, 2014

  • Prevent flickering of dropdown menu when requesting remote suggestions. #718
  • Reduce hint flickering. #754
  • Added Bloodhound#{clear, clearPrefetchCache, clearRemoteCache} and made it possible to reinitialize Bloodhound instances. #703
  • Invoke local function during initialization. #687
  • In addition to HTML strings, templates can now return DOM nodes. #742
  • Prevent jQuery#typeahead('val', val) from opening dropdown menus of non-active typeaheads. #646
  • Fix bug in IE that resulted in dropdown menus with overflow being closed when clicking on the scrollbar. #705
  • Only show dropdown menu if minLength is satisfied. #710

0.10.1 February 9, 2014


  • Fixed bug that prevented some ajax configs from being respected. #630
  • Event delegation on suggestion clicks is no longer broken. #118
  • Ensure dataset names are valid class name suffixes. #610
  • Added support for displayKey to be a function. #633
  • jQuery#typeahead('val') now mirrors jQuery#val(). #659
  • Datasets can now be passed to jQuery plugin as an array. #664
  • Added a noConflict method to the jQuery plugin. #612
  • Bloodhound's local property can now be a function. #485

0.10.0 February 2, 2014

Introducting Bloodhound

This release was almost a complete rewrite of typeahead.js and will hopefully lay the foundation for the 1.0.0 release. It's impossible to enumerate all of the issues that were fixed. If you want to get an idea of what issues 0.10.0 resolved, take a look at the closed issues in the 0.10.0 milestone.

The most important change in 0.10.0 is that typeahead.js was broken up into 2 individual components: Bloodhound and jQuery#typeahead. Bloodhound is an feature-rich suggestion engine. jQuery#typeahead is a jQuery plugin that turns input controls into typeaheads.

It's impossible to write a typeahead library that supports every use-case out of the box – that was the main motivation behind decomposing typeahead.js. Previously, some prospective typeahead.js users were unable to use the library because either the suggestion engine or the typeahead UI did not meet their requirements. In those cases, they were either forced to fork typeahead.js and make the necessary modifications or they had to give up on using typeahead.js entirely. Now they have the option of swapping out the component that doesn't work for them with a custom implementation.

0.9.3 June 24, 2013

  • Ensure cursor visibility in menus with overflow. #209
  • Fixed bug that led to the menu staying open when it should have been closed. #260
  • Private browsing in Safari no longer breaks prefetch. #270
  • Pressing tab while a suggestion is highlighted now results in a selection. #266
  • Dataset name is now passed as an argument for typeahead:selected event. #207

0.9.2 April 14, 2013

  • Prefetch usage no longer breaks when cookies are disabled. #190
  • Precompiled templates are now wrapped in the appropriate DOM element. #172

0.9.1 April 1, 2013

  • Multiple requests no longer get sent for a query when datasets share a remote source. #152
  • Datasets now support precompiled templates. #137
  • Cached remote suggestions now get rendered immediately. #156
  • Added typeahead:autocompleted event. #132
  • Added a plugin method for programmatically setting the query. Experimental. #159
  • Added minLength option for datasets. Experimental. #131
  • Prefetch objects now support thumbprint option. Experimental. #157

0.9.0 March 24, 2013

Custom events, no more typeahead.css, and an improved API

  • Implemented the triggering of custom events. #106
  • Got rid of typeahead.css and now apply styling through JavaScript. #15
  • Made the API more flexible and addressed a handful of remote issues by rewriting the transport component. #25
  • Added support for dataset headers and footers. #81
  • No longer cache unnamed datasets. #116
  • Made the key name of the value property configurable. #115
  • Input values set before initialization of typeaheads are now respected. #109
  • Fixed an input value/hint casing bug. #108

0.8.2 March 04, 2013

  • Fixed bug causing error to be thrown when initializing a typeahead on multiple elements. #51
  • Tokens with falsy values are now filtered out – was causing wonky behavior. #75
  • No longer making remote requests for blank queries. #74
  • Datums with regex characters in their value no longer cause errors. #77
  • Now compatible with the Closure Compiler. #48
  • Reference to jQuery is now obtained through window.jQuery, not window.$. #47
  • Added a plugin method for destroying typeaheads. Won't be documented until v0.9 and might change before then. #59

0.8.1 February 25, 2013

  • Fixed bug preventing local and prefetch from being used together. #39
  • No longer prevent default browser behavior when up or down arrow is pressed with a modifier. #6
  • Hint is hidden when user entered query is wider than the input. #26
  • Data stored in localStorage now expires properly. #34
  • Normalized search tokens and fixed query tokenization. #38
  • Remote suggestions now are appended, not prepended to suggestions list. #40
  • Fixed some typos through the codebase. #3

0.8.0 February 19, 2013

Initial public release

  • Prefetch and search data locally insanely fast.
  • Search hard-coded, prefetched, and/or remote data.
  • Hinting.
  • RTL/IME/international support.
  • Search multiple datasets.
  • Share datasets (and caching) between multiple inputs.
  • And much, much more...