Blame view

node_modules/bonjour/lib/browser.js 5.54 KB
aaac7fed   liuqimichale   add
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
  'use strict'
  
  var util = require('util')
  var EventEmitter = require('events').EventEmitter
  var serviceName = require('multicast-dns-service-types')
  var dnsEqual = require('dns-equal')
  var dnsTxt = require('dns-txt')
  
  var TLD = '.local'
  var WILDCARD = '_services._dns-sd._udp' + TLD
  
  module.exports = Browser
  
  util.inherits(Browser, EventEmitter)
  
  /**
   * Start a browser
   *
   * The browser listens for services by querying for PTR records of a given
   * type, protocol and domain, e.g. _http._tcp.local.
   *
   * If no type is given, a wild card search is performed.
   *
   * An internal list of online services is kept which starts out empty. When
   * ever a new service is discovered, it's added to the list and an "up" event
   * is emitted with that service. When it's discovered that the service is no
   * longer available, it is removed from the list and a "down" event is emitted
   * with that service.
   */
  function Browser (mdns, opts, onup) {
    if (typeof opts === 'function') return new Browser(mdns, null, opts)
  
    EventEmitter.call(this)
  
    this._mdns = mdns
    this._onresponse = null
    this._serviceMap = {}
    this._txt = dnsTxt(opts.txt)
  
    if (!opts || !opts.type) {
      this._name = WILDCARD
      this._wildcard = true
    } else {
      this._name = serviceName.stringify(opts.type, opts.protocol || 'tcp') + TLD
      if (opts.name) this._name = opts.name + '.' + this._name
      this._wildcard = false
    }
  
    this.services = []
  
    if (onup) this.on('up', onup)
  
    this.start()
  }
  
  Browser.prototype.start = function () {
    if (this._onresponse) return
  
    var self = this
  
    // List of names for the browser to listen for. In a normal search this will
    // be the primary name stored on the browser. In case of a wildcard search
    // the names will be determined at runtime as responses come in.
    var nameMap = {}
    if (!this._wildcard) nameMap[this._name] = true
  
    this._onresponse = function (packet, rinfo) {
      if (self._wildcard) {
        packet.answers.forEach(function (answer) {
          if (answer.type !== 'PTR' || answer.name !== self._name || answer.name in nameMap) return
          nameMap[answer.data] = true
          self._mdns.query(answer.data, 'PTR')
        })
      }
  
      Object.keys(nameMap).forEach(function (name) {
        // unregister all services shutting down
        goodbyes(name, packet).forEach(self._removeService.bind(self))
  
        // register all new services
        var matches = buildServicesFor(name, packet, self._txt, rinfo)
        if (matches.length === 0) return
  
        matches.forEach(function (service) {
          if (self._serviceMap[service.fqdn]) return // ignore already registered services
          self._addService(service)
        })
      })
    }
  
    this._mdns.on('response', this._onresponse)
    this.update()
  }
  
  Browser.prototype.stop = function () {
    if (!this._onresponse) return
  
    this._mdns.removeListener('response', this._onresponse)
    this._onresponse = null
  }
  
  Browser.prototype.update = function () {
    this._mdns.query(this._name, 'PTR')
  }
  
  Browser.prototype._addService = function (service) {
    this.services.push(service)
    this._serviceMap[service.fqdn] = true
    this.emit('up', service)
  }
  
  Browser.prototype._removeService = function (fqdn) {
    var service, index
    this.services.some(function (s, i) {
      if (dnsEqual(s.fqdn, fqdn)) {
        service = s
        index = i
        return true
      }
    })
    if (!service) return
    this.services.splice(index, 1)
    delete this._serviceMap[fqdn]
    this.emit('down', service)
  }
  
  // PTR records with a TTL of 0 is considered a "goodbye" announcement. I.e. a
  // DNS response broadcasted when a service shuts down in order to let the
  // network know that the service is no longer going to be available.
  //
  // For more info see:
  // https://tools.ietf.org/html/rfc6762#section-8.4
  //
  // This function returns an array of all resource records considered a goodbye
  // record
  function goodbyes (name, packet) {
    return packet.answers.concat(packet.additionals)
      .filter(function (rr) {
        return rr.type === 'PTR' && rr.ttl === 0 && dnsEqual(rr.name, name)
      })
      .map(function (rr) {
        return rr.data
      })
  }
  
  function buildServicesFor (name, packet, txt, referer) {
    var records = packet.answers.concat(packet.additionals).filter(function (rr) {
      return rr.ttl > 0 // ignore goodbye messages
    })
  
    return records
      .filter(function (rr) {
        return rr.type === 'PTR' && dnsEqual(rr.name, name)
      })
      .map(function (ptr) {
        var service = {
          addresses: []
        }
  
        records
          .filter(function (rr) {
            return (rr.type === 'SRV' || rr.type === 'TXT') && dnsEqual(rr.name, ptr.data)
          })
          .forEach(function (rr) {
            if (rr.type === 'SRV') {
              var parts = rr.name.split('.')
              var name = parts[0]
              var types = serviceName.parse(parts.slice(1, -1).join('.'))
              service.name = name
              service.fqdn = rr.name
              service.host = rr.data.target
              service.referer = referer
              service.port = rr.data.port
              service.type = types.name
              service.protocol = types.protocol
              service.subtypes = types.subtypes
            } else if (rr.type === 'TXT') {
              service.rawTxt = rr.data
              service.txt = txt.decode(rr.data)
            }
          })
  
        if (!service.name) return
  
        records
          .filter(function (rr) {
            return (rr.type === 'A' || rr.type === 'AAAA') && dnsEqual(rr.name, service.host)
          })
          .forEach(function (rr) {
            service.addresses.push(rr.data)
          })
  
        return service
      })
      .filter(function (rr) {
        return !!rr
      })
  }