node_modules/encodeurl/index.js

   1 /*!
   2  * encodeurl
   3  * Copyright(c) 2016 Douglas Christopher Wilson
   4  * MIT Licensed
   5  */
   6
   7 'use strict'
   8
   9 /**
  10  * Module exports.
  11  * @public
  12  */
  13
  14 module.exports = encodeUrl
  15
  16 /**
  17  * RegExp to match non-URL code points, *after* encoding (i.e. not including "%")
  18  * and including invalid escape sequences.
  19  * @private
  20  */
  21
  22 var ENCODE_CHARS_REGEXP = /(?:[^\x21\x25\x26-\x3B\x3D\x3F-\x5B\x5D\x5F\x61-\x7A\x7E]|%(?:[^0-9A-Fa-f]|[0-9A-Fa-f][^0-9A-Fa-f]|$))+/g
  23
  24 /**
  25  * RegExp to match unmatched surrogate pair.
  26  * @private
  27  */
  28
  29 var UNMATCHED_SURROGATE_PAIR_REGEXP = /(^|[^\uD800-\uDBFF])[\uDC00-\uDFFF]|[\uD800-\uDBFF]([^\uDC00-\uDFFF]|$)/g
  30
  31 /**
  32  * String to replace unmatched surrogate pair with.
  33  * @private
  34  */
  35
  36 var UNMATCHED_SURROGATE_PAIR_REPLACE = '$1\uFFFD$2'
  37
  38 /**
  39  * Encode a URL to a percent-encoded form, excluding already-encoded sequences.
  40  *
  41  * This function will take an already-encoded URL and encode all the non-URL
  42  * code points. This function will not encode the "%" character unless it is
  43  * not part of a valid sequence (`%20` will be left as-is, but `%foo` will
  44  * be encoded as `%25foo`).
  45  *
  46  * This encode is meant to be "safe" and does not throw errors. It will try as
  47  * hard as it can to properly encode the given URL, including replacing any raw,
  48  * unpaired surrogate pairs with the Unicode replacement character prior to
  49  * encoding.
  50  *
  51  * @param {string} url
  52  * @return {string}
  53  * @public
  54  */
  55
  56 function encodeUrl (url) {
  57   return String(url)
  58     .replace(UNMATCHED_SURROGATE_PAIR_REGEXP, UNMATCHED_SURROGATE_PAIR_REPLACE)
  59     .replace(ENCODE_CHARS_REGEXP, encodeURI)
  60 }