docs: function set_path(params) {
      const this_component = this;
      const current_url = this_component.state.url;
      const new_url_params = VALIDATION.ensure_valid_url_params(params);
      const new_url = new_url_params.url;
      if (!current_url
          || current_url.pathname !== new_url.pathname
          || current_url.query !== new_url.query
          || current_url.hash !== new_url.hash
          ) { // eslint-disable-line indent
          this_component.setState(new_url_params);
      }
      return true;
  }