Function focusOrLaunch

background_scripts/marks.js:87–110

(markInfo, req)

// The tab we're trying to find no longer exists. We either find another tab with a matching URL and
// use it, or we create a new tab.
async function focusOrLaunch(markInfo, req) {
  // If we're not going to be scrolling to a particular position in the tab, then we choose all tabs
  // with a matching URL prefix. Otherwise, we require an exact match (because it doesn't make sense
  // to scroll unless there's an exact URL match).
  const markIsScrolled = markInfo.scrollX > 0 || markInfo.scrollY > 0;
  const query = markIsScrolled ? markInfo.url : `${markInfo.url}*`;
  const tabs = await chrome.tabs.query({ url: query });
  if (tabs.length > 0) {
    // There is at least one matching tab. Pick one and go to it.
    const tab = await pickTab(tabs);
    gotoPositionInTab(Object.assign(markInfo, { tabId: tab.id }));
  } else {
    // There is no existing matching tab. We'll have to create one.
    TabOperations.openUrlInNewTab(
      Object.assign(req, { url: getBaseUrl(markInfo.url) }),
      (tab) => {
        // Note. tabLoadedHandlers is defined in "main.js". The handler below will be called when
        // the tab is loaded, its DOM is ready and it registers with the background page.
        return tabLoadedHandlers[tab.id] = () =>
          gotoPositionInTab(Object.assign(markInfo, { tabId: tab.id }));
      },
    );
  }
}

// Given a list of tabs candidate tabs, pick one. Prefer tabs in the current window and tabs with
// shorter (matching) URLs.