Introduce concept of provisional destinations to print preview

chrome/browser/resources/print_preview/search/destination_search.js

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 cr.define('print_preview', function() {
   'use strict';
 
   /**
    * Component used for searching for a print destination.
    * This is a modal dialog that allows the user to search and select a
@@ skipping 48 matching lines @@
 
     /**
      * Whether or not a UMA histogram for the register promo being shown was
      * already recorded.
      * @type {boolean}
      * @private
      */
     this.registerPromoShownMetricRecorded_ = false;
 
     /**
+     * Child overlay used for resolving a provisional destination. The overlay
+     * is shown when the user attempts to select a provisional destination.
+     * Set only when a destination is being resolved.
+     * @private {?print_preview.ProvisionalDestinationResolver}
+     */
+    this.provisionalDestinationResolver_ = null;
+
+    /**
      * Search box used to search through the destination lists.
      * @type {!print_preview.SearchBox}
      * @private
      */
     this.searchBox_ = new print_preview.SearchBox(
         loadTimeData.getString('searchBoxPlaceholder'));
     this.addChild(this.searchBox_);
 
     /**
      * Destination list containing recent destinations.
@@ skipping 67 matching lines @@
         this.reflowLists_();
         this.metrics_.record(
             print_preview.Metrics.DestinationSearchBucket.DESTINATION_SHOWN);
 
         this.destinationStore_.startLoadAllDestinations();
         this.invitationStore_.startLoadingInvitations();
       } else {
         // Collapse all destination lists
         this.localList_.setIsShowAll(false);
         this.cloudList_.setIsShowAll(false);
+        if (this.provisionalDestinationResolver_)
+          this.provisionalDestinationResolver_.cancel();
         this.resetSearch_();
       }
     },
 
     /** @override */
     onCancelInternal: function() {
       this.metrics_.record(print_preview.Metrics.DestinationSearchBucket.
           DESTINATION_CLOSED_UNCHANGED);
     },
 
@@ skipping 59 matching lines @@
           print_preview.DestinationStore.EventType.DESTINATION_SELECT,
           this.onDestinationStoreSelect_.bind(this));
       this.tracker.add(
           this.destinationStore_,
           print_preview.DestinationStore.EventType.DESTINATION_SEARCH_STARTED,
           this.updateThrobbers_.bind(this));
       this.tracker.add(
           this.destinationStore_,
           print_preview.DestinationStore.EventType.DESTINATION_SEARCH_DONE,
           this.onDestinationSearchDone_.bind(this));
+      this.tracker.add(
+          this.destinationStore_,
+          print_preview.DestinationStore.EventType
+              .PROVISIONAL_DESTINATION_RESOLVED,
+          this.onDestinationsInserted_.bind(this));
 
       this.tracker.add(
           this.invitationStore_,
           print_preview.InvitationStore.EventType.INVITATION_SEARCH_DONE,
           this.updateInvitations_.bind(this));
       this.tracker.add(
           this.invitationStore_,
           print_preview.InvitationStore.EventType.INVITATION_PROCESSED,
           this.updateInvitations_.bind(this));
 
@@ skipping 292 matching lines @@
      * Called when a destination search should be executed. Filters the
      * destination lists with the given query.
      * @param {Event} evt Contains the search query.
      * @private
      */
     onSearch_: function(evt) {
       this.filterLists_(evt.queryRegExp);
     },
 
     /**
+     * Handler for {@code print_preview.DestinationListItem.EventType.SELECT}
+     * event, which is called when a destinationi list item is selected.
+     * @param {Event} evt Contains the selected destination.
+     * @private
+     */
+    onDestinationSelect_: function(evt) {
+      this.handleOnDestinationSelect_(evt.destination);
+    },
+
+    /**
      * Called when a destination is selected. Clears the search and hides the
-     * widget.
-     * @param {Event} evt Contains the selected destination.
+     * widget. If The destination is provisional, it runs provisional
+     * destination resolver first.
+     * @param {!print_preview.Destination} destination The selected destination.
      * @private
      */
-    onDestinationSelect_: function(evt) {
+    handleOnDestinationSelect_: function(destination) {
+      if (destination.isProvisional) {
+        assert(!this.provisionalDestinationResolver_,
+               'Provisional destination resolver already exists.');
+        this.provisionalDestinationResolver_ =
+            print_preview.ProvisionalDestinationResolver.create(
+                this.destinationStore_, destination);
+        assert(!!this.provisionalDestinationResolver_,
+               'Unable to create provisional destination resolver');
+
+        var lastFocusedElement = document.activeElement;
+        this.addChild(this.provisionalDestinationResolver_);
+        this.provisionalDestinationResolver_.run(this.getElement())
+            .then(
+                /**
+                 * @param {!print_preview.Destination} resolvedDestination
+                 *    Destination to which the provisional destination was
+                 *    resolved.
+                 */
+                function(resolvedDestination) {
+                  this.handleOnDestinationSelect_(resolvedDestination);
+                }.bind(this))
+            .catch(
+                function() {
+                  console.log('Failed to resolve provisional destination: ' +
+                              destination.id);
+                })
+            .then(
+                function() {
+                  this.removeChild(this.provisionalDestinationResolver_);
+                  this.provisionalDestinationResolver_ = null;
+
+                  // Restore focus to the previosly focused element if it's
+                  // still shown in the search.
+                  if (lastFocusedElement &&
+                      this.getIsVisible() &&
+                      getIsVisible(lastFocusedElement) &&
+                      this.getElement().contains(lastFocusedElement)) {
+                    lastFocusedElement.focus();
+                  }
+                }.bind(this));
+        return;
+      }
+
       this.setIsVisible(false);
-      this.destinationStore_.selectDestination(evt.destination);
+      this.destinationStore_.selectDestination(destination);
       this.metrics_.record(print_preview.Metrics.DestinationSearchBucket.
           DESTINATION_CLOSED_CHANGED);
     },
 
     /**
      * Called when a destination is selected. Selected destination are marked as
      * recent, so we have to update our recent destinations list.
      * @private
      */
     onDestinationStoreSelect_: function() {
@@ skipping 123 matching lines @@
     onWindowResize_: function() {
       this.reflowLists_();
     }
   };
 
   // Export
   return {
     DestinationSearch: DestinationSearch
   };
 });