Added comment

Author: ltshb

src/api/layers/layers-external.api.js

@@ -165,6 +165,10 @@ const ENC_PIPE = '%7C'
  *
  * This percent encode the special character | used to separate external layer parameters.
  *
+ * NOTE: We don't use encodeURIComponent here because the Vue Router will anyway do the
+ * encodeURIComponent() therefore by only encoding | we avoid to encode other special character
+ * twice. But we need to encode | twice to avoid layer parsing issue.
+ *
  * @param {string} param Parameter to encode
  * @returns {string} Percent encoded parameter
  */
@@ -177,6 +181,10 @@ export function encodeExternalLayerParam(param) {
  *
  * This percent decode the special character | used to separate external layer parameters.
  *
+ * NOTE: We don't use decodeURIComponent here because the Vue Router will anyway do the
+ * decodeURIComponent() therefore by only decoding | we avoid to decode other special character
+ * twice. But we need to decode | twice to avoid layer parsing issue.
+ *
  * @param {string} param Parameter to encode
  * @returns {string} Percent encoded parameter
  */

src/router/storeSync/layersParamParser.js

@@ -10,6 +10,10 @@ const ENC_AT = '%40'
  *
  * This percent encode the special character , ; and @ used to separate layer parameters.
  *
+ * NOTE: We don't use encodeURIComponent here because the Vue Router will anyway do the
+ * encodeURIComponent() therefore by only encoding the layer parameter separators we avoid to encode
+ * other special character twice. But we need to encode them twice to avoid layer parsing issue.
+ *
  * @param {string} param Parameter to encode
  * @returns {string} Percent encoded parameter
  */
@@ -22,6 +26,10 @@ export function encodeLayerParam(param) {
  *
  * This percent decode the special character , ; and @ used to separate layer parameters.
  *
+ * NOTE: We don't use encodeURIComponent here because the Vue Router will anyway do the
+ * encodeURIComponent() therefore by only encoding the layer parameter separators we avoid to encode
+ * other special character twice. But we need to encode them twice to avoid layer parsing issue.
+ *
  * @param {string} param Parameter to encode
  * @returns {string} Percent encoded parameter
  */