@internetarchive/bookreader 5.0.0-18

package/tests/e2e/helpers/debug.js

@@ -0,0 +1,13 @@
+/**
+ * Enables a debugging breakpoint in TestCafe tests
+ *
+ * Usage:
+ * import debug from './helpers/debug';
+ *
+ * test(`does a thing`, async (t) => {
+ *   await debug(t);
+ * });
+ */
+export default async (t) => {
+  await t.debug().setNativeDialogHandler(() => true);
+};

package/tests/e2e/helpers/desktopSearch.js

@@ -0,0 +1,72 @@
+import { ClientFunction, RequestMock } from 'testcafe';
+import { SEARCH_INSIDE_URL_RE , mockResponseFound, mockResponseNotFound,
+  TEST_TEXT_FOUND, TEST_TEXT_NOT_FOUND, PAGE_FIRST_RESULT, SEARCH_MATCHES_LENGTH } from './mockSearch';
+
+
+export function runDesktopSearchTests(br) {
+  //building mock response  for successful and unsuccessful search
+  const mockFound = RequestMock()
+    .onRequestTo(SEARCH_INSIDE_URL_RE )
+    .respond(mockResponseFound, 202);
+
+  const mockNotFound = RequestMock()
+    .onRequestTo(SEARCH_INSIDE_URL_RE )
+    .respond(mockResponseNotFound, 202);
+
+
+  test
+    .requestHooks(mockFound)('Desktop search - successful search', async t => {
+      const nav = br.nav;
+
+      //assuring that the search bar is enabled
+      await t.expect(nav.desktop.searchBox.visible).ok();
+
+      //testing search for a word found in the book
+      await t
+        .selectText(nav.desktop.searchBox.child('.BRsearchInput'))
+        .pressKey('delete');
+      await t.typeText(nav.desktop.searchBox.child('.BRsearchInput'), TEST_TEXT_FOUND);
+      await t.click((nav.desktop.searchBox).child('.BRsearchSubmit'));
+      await t.expect(nav.desktop.searchPin.exists).ok();
+      await t.expect(nav.desktop.searchPin.child('.BRquery').child('div').exists).ok();
+      await t.expect(nav.desktop.searchPin.child('.BRquery').child('div').innerText).contains(TEST_TEXT_FOUND);
+      await t.expect(nav.desktop.searchNavigation.exists).ok();
+      await t.expect(nav.desktop.searchNavigation.find('[data-id="resultsCount"]').exists).ok();
+      await t.expect(nav.desktop.searchNavigation.find('[data-id="resultsCount"]').innerText).contains(SEARCH_MATCHES_LENGTH);
+
+      //checking url
+      const getPageUrl = ClientFunction(() => window.location.href.toString());
+      await t.expect(getPageUrl()).contains(TEST_TEXT_FOUND);
+
+      //checks clicking on first search pin opens correct page
+      await t.click(nav.desktop.searchPin);
+      await t.expect(getPageUrl()).contains(PAGE_FIRST_RESULT);
+
+      //checks highlight on result page is visible
+      const highlight = br.shell.find(".searchHiliteLayer rect");
+      await t.expect(highlight.visible).ok();
+
+    });
+
+
+  test
+    .requestHooks(mockNotFound)('Desktop search - unsuccessful search', async t => {
+      const nav = br.nav;
+
+      //assuring that the search bar is enabled
+      await t.expect(nav.desktop.searchBox.visible).ok();
+
+      //testing search for a word not found in the book
+      await t
+        .selectText(nav.desktop.searchBox.child('.BRsearchInput'))
+        .pressKey('delete');
+      await t.typeText(nav.desktop.searchBox.child('.BRsearchInput'), TEST_TEXT_NOT_FOUND);
+      await t.click((nav.desktop.searchBox).child('.BRsearchSubmit'));
+      await t.expect(nav.desktop.searchPin.child('.BRquery').child('div').withText(TEST_TEXT_NOT_FOUND).exists).notOk();
+
+      const getPageUrl = ClientFunction(() => window.location.href.toString());
+      await t.expect(getPageUrl()).contains(TEST_TEXT_NOT_FOUND);
+    });
+
+
+}

package/tests/e2e/helpers/mobileSearch.js

@@ -0,0 +1,85 @@
+import { ClientFunction, RequestMock } from 'testcafe';
+import { SEARCH_INSIDE_URL_RE , mockResponseFound, mockResponseNotFound,
+  TEST_TEXT_FOUND, TEST_TEXT_NOT_FOUND, PAGE_FIRST_RESULT } from './mockSearch';
+
+
+export function runMobileSearchTests(br) {
+  //building mock response  for successful and unsuccessful search
+  const mockFound = RequestMock()
+    .onRequestTo(SEARCH_INSIDE_URL_RE )
+    .respond(mockResponseFound, 202);
+
+  const mockNotFound = RequestMock()
+    .onRequestTo(SEARCH_INSIDE_URL_RE )
+    .respond(mockResponseNotFound, 202);
+
+  test
+    .requestHooks(mockFound)('Mobile search - successful search', async t => {
+      await t.resizeWindowToFitDevice('Sony Xperia Z', {portraitOrientation: true});
+      const nav = br.nav.mobile;
+
+      //opening side menu and search
+      await t.expect(nav.hamburgerButton.visible).ok();
+      await t.click(nav.hamburgerButton);
+      await t.expect(nav.menuSearchButton.visible).ok();
+      await t.click(nav.menuSearchButton);
+
+      //assuring that the search bar is enabled
+      await t.expect(nav.searchBox.visible).ok();
+
+      //testing successful search
+      await t
+        .selectText(nav.searchBox.find('[name="query"]'))
+        .pressKey('delete');
+      await t
+        .typeText(nav.searchBox.find('[name="query"]'), TEST_TEXT_FOUND)
+        .pressKey('enter');
+      await t.expect(nav.searchResults.visible).ok();
+      await t.expect(nav.searchResultText.exists).ok();
+      await t.expect(nav.searchResultText.innerText).contains(TEST_TEXT_FOUND);
+
+      //checking url
+      const getPageUrl = ClientFunction(() => window.location.href);
+      await t.expect(getPageUrl()).contains(TEST_TEXT_FOUND);
+
+      //checks clicking on first search result opens correct page
+      await t.click(nav.searchResults.child(0));
+      await t.expect(getPageUrl()).contains(PAGE_FIRST_RESULT);
+
+      //checks highlight on result page is visible
+      const highlight = br.shell.find(".searchHiliteLayer rect");
+      await t.expect(highlight.visible).ok();
+
+      await t.maximizeWindow();
+    });
+
+  test
+    .requestHooks(mockNotFound)('Mobile search - unsuccessful search', async t => {
+      await t.resizeWindowToFitDevice('Sony Xperia Z', {portraitOrientation: true});
+      const nav = br.nav.mobile;
+
+      //opening side menu and search
+      await t.expect(nav.hamburgerButton.visible).ok();
+      await t.click(nav.hamburgerButton);
+      await t.expect(nav.menuSearchButton.visible).ok();
+      await t.click(nav.menuSearchButton);
+
+      //assuring that the search bar is enabled
+      await t.expect(nav.searchBox.visible).ok();
+
+      //testing unsuccessful search
+      await t
+        .selectText(nav.searchBox.find('[name="query"]'))
+        .pressKey('delete');
+      await t
+        .typeText(nav.searchBox.find('[name="query"]'), TEST_TEXT_NOT_FOUND)
+        .pressKey('enter');
+      await t.expect(nav.searchResultText.withText(TEST_TEXT_NOT_FOUND).exists).notOk();
+
+      //checking url
+      const getPageUrl = ClientFunction(() => window.location.href.toString());
+      await t.expect(getPageUrl()).contains(TEST_TEXT_NOT_FOUND);
+      await t.maximizeWindow();
+    });
+
+}

package/tests/e2e/helpers/mockSearch.js

@@ -0,0 +1,93 @@
+export const TEST_TEXT_FOUND = 'theory';
+export const TEST_TEXT_NOT_FOUND = 'HopefullyNotFoundLongWord';
+export const PAGE_FIRST_RESULT = 30;
+
+export const SEARCH_INSIDE_URL_RE  = /https:\/\/ia[0-9]+\.us\.archive\.org\/fulltext\/inside\.php\?item_id=.*/;
+
+//adding jQueryxxxxxxxx-xxxxxxxx (semi-random numbers) from request url to returned search request object
+/** Mock response for a matching search term. */
+export function mockResponseFound(req, res) {
+  const requestUrl = new URL(req.url);
+  const jqueryUrl = requestUrl.searchParams.get("callback");
+  const wholeString = jqueryUrl + '(' + JSON.stringify(MOCKED_RESPONSE_FOUND) + ')';
+  res.setBody(wholeString);
+}
+
+/** Mock response for a matching search term. */
+export function mockResponseNotFound(req, res) {
+  const requestUrl = new URL(req.url);
+  const jqueryUrl = requestUrl.searchParams.get("callback");
+  const wholeString = jqueryUrl + '(' + JSON.stringify(MOCKED_RESPONSE_NOT_FOUND) + ')';
+  res.setBody(wholeString);
+}
+
+const PAGE_FIRST_RESULT_ADJUSTED = PAGE_FIRST_RESULT + 12;
+//mocked objects inside an unsuccessful search and of a random successful search returned by search requests
+const MOCKED_RESPONSE_NOT_FOUND = {
+  "ia": "theworksofplato01platiala",
+  "q": TEST_TEXT_NOT_FOUND,
+  "indexed": true,
+  "page_count": 1,
+  "body_length": 666,
+  "leaf0_missing": true,
+  "matches": []
+};
+
+const MOCKED_RESPONSE_FOUND = {
+  "ia": "This request has been mocked",
+  "q": TEST_TEXT_FOUND,
+  "indexed": true,
+  "page_count": 644,
+  "body_length": 666,
+  "leaf0_missing": false,
+  "matches": [
+    {
+      "text": "Everybody knows the story of another experimental philosopher who had a great {{{" + TEST_TEXT_FOUND + "}}} about a horse being able to live without eating, and who demonstrated it so well, that he got his own horse down to a straw a day, and would unquestionably have rendered him a very spirited and rampacious animal on nothing at all, if he had not died, four-and-twenty hours before he was to have had his first comfortable bait of air. Unfortunately for the experimental philosophy of the female to whose protecting care Oliver Twist was delivered over, a similar result usually attended the operation of her system; for at the very moment when a child had contrived to exist upon the smallest possible portion of the weakest possible food, it did perversely happen in eight and a half cases out of ten, either that it sickened from want and cold, or fell into the fire from neglect, or got half-smothered by accident; in any one of which cases, the miserable little being was usually summoned into another world, and there gathered to the fathers it had never known in this.",
+      "par": [
+        {
+          "boxes": [
+            {
+              "r": 1045,
+              "b": 811,
+              "t": 753,
+              "page": PAGE_FIRST_RESULT_ADJUSTED,
+              "l": 894
+            }
+          ],
+          "b": 1935,
+          "t": 686,
+          "page_width": 1790,
+          "r": 1704,
+          "l": 148,
+          "page_height": 2940,
+          "page": PAGE_FIRST_RESULT_ADJUSTED
+        }
+      ]
+    },
+    {
+      "text": "That when the Dodger, and his accomplished friend Master Bates, joined in the hue-and-cry which was raised at Oliver's heels, in consequence of their executing an illegal conveyance of Mr. Brownlow's personal property, as has been already described, they were actuated by a very laudable and becoming regard for themselves ; and forasmuch as the freedom of the subject and the liberty of the individual are among the first and proudest boasts of a true-hearted Englishman, so, I need hardly beg the reader to observe, that this action should tend to exalt them in the opinion of all jniblic and patriotic men, in almost as great a degree as this strong proof of their anxiety for their own preservation and safety goes to corroborate and confirm the little code of laws which certain profound and sound-judging philosophers have laid down as the mainsprings of all Nature's deeds and actions : the said philosophers very wisely reducing the good lady's proceedings to matters of maxim and {{{" + TEST_TEXT_FOUND + "}}} : and, by a very neat and pretty compliment   to   her   exalted   wisdom   and   understanding,   putting entirely out of sight any considerations of heart, or generous impulse and feeling. For, these are matters totally beneath a female who is acknowledged by universal admission to be far above the numerous little foibles and weaknesses of her sex.",
+      "par": [
+        {
+          "boxes": [
+            {
+              "r": 593,
+              "b": 2567,
+              "t": 2507,
+              "page": 162,
+              "l": 441
+            }
+          ],
+          "b": 2631,
+          "t": 1439,
+          "page_width": 1790,
+          "r": 1620,
+          "l": 56,
+          "page_height": 2940,
+          "page": 162
+        }
+      ]
+    }
+  ]
+};
+
+export const SEARCH_MATCHES_LENGTH = MOCKED_RESPONSE_FOUND.matches.length;

package/tests/e2e/helpers/rightToLeft.js

@@ -0,0 +1,29 @@
+import { ClientFunction } from 'testcafe';
+const getPageUrl = ClientFunction(() => window.location.href);
+
+export function runRightToLeftTests (br) {
+  test('Right to Left - correct initialization in two-page view', async t => {
+    const { nav, BRcontainer} = br;
+    await t.click(nav.desktop.mode2Up);
+
+    //checking right leaf edge has 0 width
+    await t.expect(BRcontainer.find('.BRleafEdgeR').getStyleProperty('width')).eql('0px');
+
+    //checking empty page before the cover is more to the left than the first page
+    const rightEmptyPage = BRcontainer.find('.BRpagecontainer.BRemptypage');
+    const leftPage = BRcontainer.find('.BRpagecontainer.pagediv0');
+    const leftPageLDistance = leftPage.getBoundingClientRectProperty('left');
+    const rightPageLDistance = rightEmptyPage.getBoundingClientRectProperty('left');
+    await t.expect(rightPageLDistance).gt(await leftPageLDistance);
+
+    //checks slider is in correct position
+    await t.expect(nav.desktop.sliderRange.getStyleProperty('width')).eql('0px');
+  });
+
+  test('Right to Left - assuring flipping left goes to next page', async t => {
+    const { nav } = br;
+    await t.click(nav.desktop.mode2Up);
+    await t.click(nav.desktop.goLeft);
+    await t.expect(getPageUrl()).match(/page\/n2/);
+  });
+}

package/tests/e2e/ia-production/ia-prod-base.js

@@ -0,0 +1,17 @@
+import { runBaseTests } from '../helpers/base';
+import BookReader from '../models/BookReader';
+
+const localURL = 'https://archive.org/details/';
+const books = [
+  'birdbookillustra00reedrich', // publicDomain
+  // 'pianoservicingtu00rebl_0', // borrowable,
+  // 'adventuresoftoms00twaiiala', // has chapter markers
+  // 'gendaitankashu00meijuoft', // Right to Left book
+  // 'gov.uspto.patents.application.10074026', // multiple files
+];
+
+books.forEach(function(page) {
+  const url = `${localURL}${page}`;
+  fixture `Archive.org BR Base Tests for: ${page}`.page `${url}`;
+  runBaseTests(new BookReader());
+});

package/tests/e2e/models/BookReader.js

@@ -0,0 +1,11 @@
+import { Selector } from 'testcafe';
+import Nav from './Navigation';
+
+/** Model defining BookReader base elements */
+export default class BookReader {
+  constructor () {
+    this.shell = new Selector('.BookReader');
+    this.BRcontainer = new Selector('.BRcontainer');
+    this.nav = new Nav();
+  }
+}

package/tests/e2e/models/Navigation.js

@@ -0,0 +1,56 @@
+import { Selector } from 'testcafe';
+
+/** Model defining BookReader's Navigation base elements */
+export default class Navigation {
+  constructor() {
+    this.topNavShell = new Selector('.BRtoolbar');
+    this.bottomNavShell = new Selector('.BRfooter');
+    this.mobileMenu = new Selector('.BRmobileMenu');
+    this.desktop = new DesktopNav(this.bottomNavShell, this.topNavShell);
+    this.mobile = new MobileNav(this.mobileMenu, this.topNavShell);
+  }
+}
+
+/**
+ * DesktopNav Model
+ * @class
+ * @classdesc defines DesktopNav base elements
+ */
+class DesktopNav {
+  constructor(bottomToolbar, topToolbar) {
+    // flipping
+    this.goLeft = bottomToolbar.find('.BRicon.book_left');
+    this.goRight = bottomToolbar.find('.BRicon.book_right');
+    this.goNext = bottomToolbar.find('.BRicon.book_flip_next');
+    this.goPrev = bottomToolbar.find('.BRicon.book_flip_prev');
+
+    // mode switching
+    this.mode1Up = bottomToolbar.find('.BRicon.onepg');
+    this.mode2Up = bottomToolbar.find('.BRicon.twopg');
+    this.modeThumb = bottomToolbar.find('.BRicon.thumb');
+    this.viewmode = bottomToolbar.find('.BRicon.viewmode');
+
+    // zoom
+    this.zoomIn = bottomToolbar.find('.BRicon.zoom_in');
+    this.zoomOut = bottomToolbar.find('.BRicon.zoom_out');
+
+    // search
+    this.searchBox = topToolbar.find('.BRbooksearch.desktop');
+    this.searchPin = bottomToolbar.find('.BRsearch');
+    this.searchNavigation = bottomToolbar.find('.BRsearch-navigation');
+
+    // other
+    this.fullScreen = bottomToolbar.find('.BRicon.full');
+    this.sliderRange = bottomToolbar.find('.ui-slider-range');
+  }
+}
+
+class MobileNav {
+  constructor(mobileMenu, topToolbar) {
+    this.hamburgerButton = topToolbar.find('.BRmobileHamburger');
+    this.menuSearchButton = mobileMenu.find('.BRmobileMenu__search');
+    this.searchBox = mobileMenu.find('#BRsearch_tray');
+    this.searchResults = mobileMenu.find('[data-id="results"]');
+    this.searchResultText = this.searchResults.child(0).find('p');
+  }
+}

package/tests/e2e/rightToLeft.test.js

@@ -0,0 +1,20 @@
+import { runBaseTests } from './helpers/base';
+import { runRightToLeftTests } from './helpers/rightToLeft';
+
+import BookReader from './models/BookReader';
+
+const { BASE_URL } = process.env;
+const DEMO_PATH = 'demo-internetarchive.html?ocaid=';
+const OCAIDS = [
+  'gendaitankashu00meijuoft', // Right to Left book
+];
+
+OCAIDS.forEach(ocaid => {
+  const url = `${BASE_URL}${DEMO_PATH}${ocaid}`;
+
+  fixture `Base Tests for right to left book: ${ocaid}`.page `${url}`;
+  runBaseTests(new BookReader({ pageProgression: 'rl' }));
+
+  fixture `Specific Tests for right to left book: ${ocaid}`.page `${url}`;
+  runRightToLeftTests(new BookReader());
+});

package/tests/e2e/viewmode.test.js

@@ -0,0 +1,37 @@
+import { Selector } from 'testcafe';
+import BookReader from './models/BookReader';
+
+const { BASE_URL } = process.env;
+
+fixture `Viewmode carousel`.page `${BASE_URL}viewmode-cycle.html`;
+
+test('Clicking `view mode` cycles through view modes', async t => {
+  const { nav } = (new BookReader());
+
+  // viewmode button only appear on mobile devices
+  await t.resizeWindow(400, 800);
+  // Flip forward one
+  await t.pressKey('right');
+
+  // 2up to thumb
+  await t.click(nav.desktop.viewmode);
+  const thumbnailContainer = Selector('.BRmodeThumb');
+  await t.expect(thumbnailContainer.visible).ok();
+  const thumbImages = thumbnailContainer.find('.BRpageview img');
+  await t.expect(thumbImages.count).gt(0);
+
+  // thumb to 1up
+  await t.click(nav.desktop.viewmode);
+  const onePageViewContainer = Selector('br-mode-1up');
+  await t.expect(onePageViewContainer.visible).ok();
+  const onePageImages = onePageViewContainer.find('.BRmode1up .BRpagecontainer');
+  // we usually pre-fetch the page in question & 1 before/after it
+  await t.expect(onePageImages.count).gte(3);
+
+  // 1up to 2up
+  await t.click(nav.desktop.viewmode);
+  const twoPageContainer = Selector('.BRtwopageview');
+  await t.expect(twoPageContainer.visible).ok();
+  const twoPageImages = twoPageContainer.find('img.BRpageimage');
+  await t.expect(twoPageImages.count).gte(2);
+});

package/tests/karma/BookNavigator/book-navigator.test.js

@@ -0,0 +1,180 @@
+import {
+  html,
+  elementUpdated,
+  fixtureCleanup,
+  fixtureSync,
+  expect,
+} from '@open-wc/testing';
+import sinon from 'sinon';
+
+import '../../../src/BookNavigator/BookNavigator.js';
+import BRFullscreenMgr from '../../../src/BookNavigator/br-fullscreen-mgr.js';
+
+const container = () => {
+  const item = {};
+  return html`
+    <book-navigator
+      .item=${item}
+      .baseHost
+    >
+      <div slot="bookreader">
+        <p class="visible-in-reader">now showing</p>
+      <div>
+      <p class="bunny">foo</p>
+      </
+  `;
+};
+
+beforeEach(() => {
+  const body = document.querySelector('body');
+  const brHook = document.createElement('div');
+  brHook.setAttribute('id', 'BookReader');
+  body.appendChild(brHook);
+});
+
+afterEach(() => {
+  window.br = null;
+  fixtureCleanup();
+});
+
+
+describe('<book-navigator>', () => {
+  describe('first update', () => {
+    it('binds global event listeners', async () => {
+      const el = fixtureSync(container());
+      const spy = sinon.spy(el, 'bindEventListeners');
+      await elementUpdated(el);
+      expect(spy.callCount).to.equal(1);
+    });
+
+    it('emits a BrBookNav:PostInit event', async () => {
+      let initEventFired = false;
+      window.addEventListener('BrBookNav:PostInit', (e) => {
+        initEventFired = true;
+      });
+      const el = fixtureSync(container());
+      const spy = sinon.spy(el, 'emitPostInit');
+      await elementUpdated(el);
+
+      expect(initEventFired).to.be.true;
+      expect(spy.callCount).to.equal(1);
+    });
+  });
+
+  it('handles global event: BookReader:PostInit', async () => {
+    const setTimeoutSpy = sinon.spy(window, 'setTimeout');
+    const brStub = {
+      resize: sinon.fake(),
+      currentIndex: sinon.fake(),
+      jumpToIndex: sinon.fake(),
+      options: { enableMultipleBooks: false }, // for multipleBooks
+      el: '#BookReader'
+    };
+
+    const el = fixtureSync(container());
+    const initializeBookSubmenus = sinon.spy(el, 'initializeBookSubmenus');
+
+    await elementUpdated(el);
+    window.dispatchEvent(new CustomEvent('BookReader:PostInit', {
+      detail: { props: brStub }
+    }));
+    await elementUpdated(el);
+
+    expect(initializeBookSubmenus.callCount).to.equal(1);
+    expect(el.bookreader).to.equal(brStub); // sets bookreader
+    expect(el.bookReaderLoaded).to.be.true; // notes bookreader is loaded
+    expect(el.bookReaderCannotLoad).to.be.false;
+    expect(el.fullscreenMgr).to.an.instanceof(BRFullscreenMgr);
+    expect(el.brResizeObserver).to.an.instanceof(window.ResizeObserver);
+    expect(setTimeoutSpy.callCount).to.equal(1); // resizes at end
+  });
+
+  it('resizes bookreader when side menu toggles', async () => {
+    const el = fixtureSync(container());
+    const brStub = {
+      resize: sinon.fake(),
+      currentIndex: sinon.fake(),
+      jumpToIndex: sinon.fake(),
+      options: { enableMultipleBooks: true },
+    };
+
+    el.bookreader = brStub;
+    await elementUpdated(el);
+
+    el.sideMenuOpen = true;
+    await elementUpdated(el);
+
+    expect(el.bookreader.resize.callCount).to.equal(1);
+
+    el.sideMenuOpen = false;
+    await elementUpdated(el);
+
+    expect(el.bookreader.resize.callCount).to.equal(2);
+  });
+
+  it('does not resize bookreader if animating', async () => {
+    const el = fixtureSync(container());
+    const brStub = {
+      animating: true, // <-- testing for this
+      resize: sinon.fake(),
+      currentIndex: sinon.fake(),
+      jumpToIndex: sinon.fake(),
+      options: { enableMultipleBooks: true }
+    };
+
+    el.bookreader = brStub;
+    await elementUpdated(el);
+
+    el.sideMenuOpen = true;
+    await elementUpdated(el);
+
+    expect(el.bookreader.resize.callCount).to.equal(0);
+    expect(el.bookreader.currentIndex.callCount).to.equal(0);
+    expect(el.bookreader.jumpToIndex.callCount).to.equal(0);
+  });
+
+  describe(`this.updateSideMenu`, () => {
+    it('emits custom event', async () => {
+      const el = fixtureSync(container());
+      const brStub = {
+        resize: sinon.fake(),
+        currentIndex: sinon.fake(),
+        jumpToIndex: sinon.fake(),
+        options: { enableMultipleBooks: true }
+      };
+      el.bookreader = brStub;
+      await elementUpdated(el);
+
+      let initEventFired = false;
+      let eventDetails = {};
+      el.addEventListener('updateSideMenu', (e) => {
+        eventDetails = e.detail;
+        initEventFired = true;
+      });
+
+      el.updateSideMenu('foo', 'open');
+      expect(initEventFired).to.equal(true);
+      expect(eventDetails.menuId).to.equal('foo');
+      expect(eventDetails.action).to.equal('open');
+    });
+    it('does not emit event if missing an arg', async() => {
+      const el = fixtureSync(container());
+      const brStub = {
+        resize: sinon.fake(),
+        currentIndex: sinon.fake(),
+        jumpToIndex: sinon.fake(),
+        options: { enableMultipleBooks: true }
+      };
+      el.bookreader = brStub;
+      await elementUpdated(el);
+
+      let initEventFired = false;
+      el.addEventListener('updateSideMenu', (e) => {
+        initEventFired = true;
+      });
+
+      el.updateSideMenu('', 'open');
+      expect(initEventFired).to.equal(false);
+    });
+  });
+});