agent.js 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295
  1. 'use strict'
  2. var assert = require('assert')
  3. var http = require('http')
  4. var https = require('https')
  5. var net = require('net')
  6. var util = require('util')
  7. var transport = require('spdy-transport')
  8. var debug = require('debug')('spdy:client')
  9. // Node.js 0.10 and 0.12 support
  10. Object.assign = process.versions.modules >= 46
  11. ? Object.assign // eslint-disable-next-line
  12. : util._extend
  13. var EventEmitter = require('events').EventEmitter
  14. var spdy = require('../spdy')
  15. var mode = /^v0\.8\./.test(process.version)
  16. ? 'rusty'
  17. : /^v0\.(9|10)\./.test(process.version)
  18. ? 'old'
  19. : /^v0\.12\./.test(process.version)
  20. ? 'normal'
  21. : 'modern'
  22. var proto = {}
  23. function instantiate (base) {
  24. function Agent (options) {
  25. this._init(base, options)
  26. }
  27. util.inherits(Agent, base)
  28. Agent.create = function create (options) {
  29. return new Agent(options)
  30. }
  31. Object.keys(proto).forEach(function (key) {
  32. Agent.prototype[key] = proto[key]
  33. })
  34. return Agent
  35. }
  36. proto._init = function _init (base, options) {
  37. base.call(this, options)
  38. var state = {}
  39. this._spdyState = state
  40. state.host = options.host
  41. state.options = options.spdy || {}
  42. state.secure = this instanceof https.Agent
  43. state.fallback = false
  44. state.createSocket = this._getCreateSocket()
  45. state.socket = null
  46. state.connection = null
  47. // No chunked encoding
  48. this.keepAlive = false
  49. var self = this
  50. this._connect(options, function (err, connection) {
  51. if (err) {
  52. return self.emit('error', err)
  53. }
  54. state.connection = connection
  55. self.emit('_connect')
  56. })
  57. }
  58. proto._getCreateSocket = function _getCreateSocket () {
  59. // Find super's `createSocket` method
  60. var createSocket
  61. var cons = this.constructor.super_
  62. do {
  63. createSocket = cons.prototype.createSocket
  64. if (cons.super_ === EventEmitter || !cons.super_) {
  65. break
  66. }
  67. cons = cons.super_
  68. } while (!createSocket)
  69. if (!createSocket) {
  70. createSocket = http.Agent.prototype.createSocket
  71. }
  72. assert(createSocket, '.createSocket() method not found')
  73. return createSocket
  74. }
  75. proto._connect = function _connect (options, callback) {
  76. var self = this
  77. var state = this._spdyState
  78. var protocols = state.options.protocols || [
  79. 'h2',
  80. 'spdy/3.1', 'spdy/3', 'spdy/2',
  81. 'http/1.1', 'http/1.0'
  82. ]
  83. // TODO(indutny): reconnect automatically?
  84. var socket = this.createConnection(Object.assign({
  85. NPNProtocols: protocols,
  86. ALPNProtocols: protocols,
  87. servername: options.servername || options.host
  88. }, options))
  89. state.socket = socket
  90. socket.setNoDelay(true)
  91. function onError (err) {
  92. return callback(err)
  93. }
  94. socket.on('error', onError)
  95. socket.on(state.secure ? 'secureConnect' : 'connect', function () {
  96. socket.removeListener('error', onError)
  97. var protocol
  98. if (state.secure) {
  99. protocol = socket.npnProtocol ||
  100. socket.alpnProtocol ||
  101. state.options.protocol
  102. } else {
  103. protocol = state.options.protocol
  104. }
  105. // HTTP server - kill socket and switch to the fallback mode
  106. if (!protocol || protocol === 'http/1.1' || protocol === 'http/1.0') {
  107. debug('activating fallback')
  108. socket.destroy()
  109. state.fallback = true
  110. return
  111. }
  112. debug('connected protocol=%j', protocol)
  113. var connection = transport.connection.create(socket, Object.assign({
  114. protocol: /spdy/.test(protocol) ? 'spdy' : 'http2',
  115. isServer: false
  116. }, state.options.connection || {}))
  117. // Pass connection level errors are passed to the agent.
  118. connection.on('error', function (err) {
  119. self.emit('error', err)
  120. })
  121. // Set version when we are certain
  122. if (protocol === 'h2') {
  123. connection.start(4)
  124. } else if (protocol === 'spdy/3.1') {
  125. connection.start(3.1)
  126. } else if (protocol === 'spdy/3') {
  127. connection.start(3)
  128. } else if (protocol === 'spdy/2') {
  129. connection.start(2)
  130. } else {
  131. socket.destroy()
  132. callback(new Error('Unexpected protocol: ' + protocol))
  133. return
  134. }
  135. if (state.options['x-forwarded-for'] !== undefined) {
  136. connection.sendXForwardedFor(state.options['x-forwarded-for'])
  137. }
  138. callback(null, connection)
  139. })
  140. }
  141. proto._createSocket = function _createSocket (req, options, callback) {
  142. var state = this._spdyState
  143. if (state.fallback) { return state.createSocket(req, options) }
  144. var handle = spdy.handle.create(null, null, state.socket)
  145. var socketOptions = {
  146. handle: handle,
  147. allowHalfOpen: true
  148. }
  149. var socket
  150. if (state.secure) {
  151. socket = new spdy.Socket(state.socket, socketOptions)
  152. } else {
  153. socket = new net.Socket(socketOptions)
  154. }
  155. handle.assignSocket(socket)
  156. handle.assignClientRequest(req)
  157. // Create stream only once `req.end()` is called
  158. var self = this
  159. handle.once('needStream', function () {
  160. if (state.connection === null) {
  161. self.once('_connect', function () {
  162. handle.setStream(self._createStream(req, handle))
  163. })
  164. } else {
  165. handle.setStream(self._createStream(req, handle))
  166. }
  167. })
  168. // Yes, it is in reverse
  169. req.on('response', function (res) {
  170. handle.assignRequest(res)
  171. })
  172. handle.assignResponse(req)
  173. // Handle PUSH
  174. req.addListener('newListener', spdy.request.onNewListener)
  175. // For v0.8
  176. socket.readable = true
  177. socket.writable = true
  178. if (callback) {
  179. return callback(null, socket)
  180. }
  181. return socket
  182. }
  183. if (mode === 'modern' || mode === 'normal') {
  184. proto.createSocket = proto._createSocket
  185. } else {
  186. proto.createSocket = function createSocket (name, host, port, addr, req) {
  187. var state = this._spdyState
  188. if (state.fallback) {
  189. return state.createSocket(name, host, port, addr, req)
  190. }
  191. return this._createSocket(req, {
  192. host: host,
  193. port: port
  194. })
  195. }
  196. }
  197. proto._createStream = function _createStream (req, handle) {
  198. var state = this._spdyState
  199. var self = this
  200. return state.connection.reserveStream({
  201. method: req.method,
  202. path: req.path,
  203. headers: req._headers,
  204. host: state.host
  205. }, function (err, stream) {
  206. if (err) {
  207. return self.emit('error', err)
  208. }
  209. stream.on('response', function (status, headers) {
  210. handle.emitResponse(status, headers)
  211. })
  212. })
  213. }
  214. // Public APIs
  215. proto.close = function close (callback) {
  216. var state = this._spdyState
  217. if (state.connection === null) {
  218. this.once('_connect', function () {
  219. this.close(callback)
  220. })
  221. return
  222. }
  223. state.connection.end(callback)
  224. }
  225. exports.Agent = instantiate(https.Agent)
  226. exports.PlainAgent = instantiate(http.Agent)
  227. exports.create = function create (base, options) {
  228. if (typeof base === 'object') {
  229. options = base
  230. base = null
  231. }
  232. if (base) {
  233. return instantiate(base).create(options)
  234. }
  235. if (options.spdy && options.spdy.plain) {
  236. return exports.PlainAgent.create(options)
  237. } else { return exports.Agent.create(options) }
  238. }