Method _validateEntitiesAsync

modules/core/ValidationSystem.js:712–755

* _validateEntitiesAsync * Schedule validation for many entities. * This may take time but happen in the background during browser idle time. * @param {ValidationCache} cache - The cache to store results in (`_head` or `_base`) * @param {Array|Set} entityIDs - The entityIDs

(cache, entityIDs)

   * @return {Promise}  Promise fulfilled when the validation has completed.
   */
  _validateEntitiesAsync(cache, entityIDs) {
    // Enqueue the work
    const jobs = Array.from(entityIDs).map(entityID => {
      if (cache.queuedEntityIDs.has(entityID)) return null;  // queued already
      cache.queuedEntityIDs.add(entityID);

      // Clear caches for existing issues related to this entity
      cache.uncacheEntityID(entityID);

      return () => {
        cache.queuedEntityIDs.delete(entityID);

        const graph = cache.graph;
        if (!graph) return;  // was reset?

        const entity = graph.hasEntity(entityID);   // Sanity check: don't validate deleted entities
        if (!entity) return;

        // detect new issues and update caches
        const result = this._validateEntity(entity, graph);
        if (result.provisional) {                       // provisional result
          cache.provisionalEntityIDs.add(entityID);     // we'll need to revalidate this entity again later
        }

        cache.cacheIssues(result.issues);   // update cache
      };

    }).filter(Boolean);

    // Perform the work in chunks.
    // Because this will happen during idle callbacks, we want to choose a chunk size
    // that won't make the browser stutter too badly.
    cache.queue = cache.queue.concat(utilArrayChunk(jobs, 50));

    // Enqueue the work
    if (!cache.queuePromise) {
      cache.queuePromise = this._processQueue(cache)
        .then(() => this._revalidateProvisionalEntities(cache))
        .catch(e => console.error(e))  // eslint-disable-line
        .finally(() => cache.queuePromise = null);
    }

    return cache.queuePromise;
  }


  /**