/** Class representing a semaphore */
export default class Semaphore {
  /**
   * Creates a semaphore.
   * @param {number} permits The number of permits, i.e. things being allowed to run in parallel.
   * To create a lock that only lets one thing run at a time, set this to 1. This number can also be negative.
   */
  constructor(permits) {
    this._permits = permits;

    this._promiseResolvers = [];
  }

  /**
   * Returns a promise used to wait for a permit to become available.
   * @return {Promise} A promise that gets resolved when execution is allowed to proceed.
   */
  async wait() {
    if (this._permits > 0) {
      this._permits -= 1;
      return Promise.resolve(true);
    }
    return new Promise(resolver => this._promiseResolvers.push(resolver));
  }

  /**
   * Same as wait except the promise returned gets resolved with <code>false</code> if no permit becomes available in time.
   * @param {number} milliseconds The time spent waiting before the wait is aborted.
   * @return {Promise} A promise that gets resolved with <code>true</code> when execution is allowed to proceed or
   * <code>false</code> if the time given elapses before a permit becomes available.
   */
  async waitFor(milliseconds) {
    if (this._permits > 0) {
      this._permits -= 1;
      return Promise.resolve(true);
    }

    let resolver;
    const promise = new Promise(r => {
      resolver = r;
    });

    this._promiseResolvers.push(resolver);

    setTimeout(() => {
      const index = this._promiseResolvers.indexOf(resolver);
      if (index !== -1) {
        this._promiseResolvers.splice(index, 1);
      }
      resolver(false);
    }, milliseconds);

    return promise;
  }

  /**
   * Synchronous function used to determine whether a permit is available.
   * @return {boolean} True if there's at least one permit available.
   */
  tryAcquire() {
    if (this._permits > 0) {
      this._permits -= 1;
      return true;
    }
    return false;
  }

  /**
   * Increases the number of permits by one. If there are other functions waiting, one of them will
   * continue to execute in a future iteration of the event loop.
   */
  signal() {
    this._permits += 1;

    if (this._permits >= 1 && this._promiseResolvers.length > 0) {
      if (this._permits > 1) {
        throw new Error('this._permits should never be > 0 when there is someone waiting.');
      }

      this._permits -= 1;
      this._promiseResolvers.shift()(true);
    }
  }

  /**
   * Schedules func to be called once a permit becomes available.
   * @param {function} func - The function to be executed.
   */
  async execute(func) {
    await this.wait();
    try {
      await func();
    } finally {
      this.signal();
    }
  }
}

@@ -841,34 +841,21 @@
 ed with 
-%3Ccode%3Efalse%3C/code%3E
+false
  if no p
@@ -1033,25 +1033,12 @@
 ith 
-%3Ccode%3Etrue%3C/code%3E
+true
  whe
@@ -1083,26 +1083,13 @@
   * 
-%3Ccode%3Efalse%3C/code%3E
+false
  if 
@@ -1687,125 +1687,145 @@
 ion 
-used to determine whether a permit is available.%0A   * @return %7Bboolean%7D True if there's at least one permit available
+that tries to acquire a permit and returns true if successful, false otherwise.%0A   * @return %7Bboolean%7D Whether a permit could be acquired
 .%0A  

Fix comment