Blame view

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