FUTURE.md

Future

• HTTP/2 support

• Investigate Windows + HTTPS + Request Stream issue (seems to only happen in tests)

  • See expectHTTPSStreamErrorOnWindows in test and where it is used.
  • See error in AppVeyor build #24 - L364

• Introductory video or gif, with real-world examples, on main README.md

• Useful examples/

  • With videos and gifs
  • Progress logging examples:
    • By percent
    • By bytes
    • Time - estimated & total

• Use makeNestedDirectory for request's toFile option

  • Update test/request/shared-options
  • Consider file URLs, which contain encoded paths

• Error messages in more languages

  • Use ISO 639-1 codes
  • See:
    • jetta.JettaError
    • lib/jetta-error.js

• Use process.env.LANG as the fallback preferredErrorLanguage

  • Perhaps:

    const preferredErrorLanguage = process.env.LANG.split('.')[0].split('_')[0]

    • Consider Chinese, where language locale matters

• Proxy support

  • Consider this from Electron: electron/electron#7577

• options.range OBJECT - an easy, convenient option for RANGE requests, in bytes

  • Can manually set range header in options.headers if interested in advanced features, such as multi-range (i.e. range: bytes=0-512,1024-)

  • from INTEGER

    • Start byte, inclusive (zero-based, i.e. 0 = 1st byte)
    • default = 0

  • to INTEGER

    • Start byte, inclusive (zero-based, i.e. if file size is 1024, 1023 would be the last byte)
    • Can be null for get all bytes from from
    • default = null

  • strict BOOLEAN

    • If data > range (content-length or actual) or if status is not 206, then cancel w/ error
    • default: true

  • See for examples and ideas:

    • http://stackoverflow.com/questions/8696523/nodejs-http-range-support-partial-file-download
    • http://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html
    • https://gist.github.com/padenot/1324734