downlinkmax/downlinkmax.coffee

downlinkMax is a 0.26KB Network Information API polyfill for navigator.connection.downlinkMax written in both CoffeeScript and JavaScript with AMD support.

###*
  @file downlinkMax is 0.26KB Network Information API downlinkMax polyfill micro-library.
  @author Daniel Lamb <dlamb.open.source@gmail.com>
###
downlinkmax = ->
  limitless = Infinity
  nav = navigator

  # deal with vendor prefixing and fallback if not supported
  connection = nav.connection or nav.mozConnection or nav.webkitConnection or downlinkMax: limitless

  # check that the API doesn't already support downlinkMax
  unless 'downlinkMax' of connection

    # assume NOT W3C Editor's Draft 09 October 2014
    # check if API supports bandwidth
    if 'bandwidth' of connection

      # assume W3C Working Draft 29 November 2012
      # standardize connection.bandwidth value by converting megabytes per second (MB/s) to megabits per second (Mbit/s)
      connection.downlinkMax = connection.bandwidth * 8
    else

      # assume W3C Working Draft 07 June 2011
      # convert connection.type value to approximate downlink values
      # speed estimate is based on the median downlink value for common devices in megabits per second (Mbit/s)
      switch connection.type
        when 'none'
          speed = 0
        when '2g'
          speed = 0.134
        when 'bluetooth', 'cellular'
          speed = 2
        when '3g'
          speed = 8.95
        when '4g'
          speed = 100
        when 'ethernet'
          speed = 550
        when 'wifi'
          speed = 600
        # other, unknown etc.
        else
          speed = limitless
      connection.downlinkMax = speed

  # return the maximum downlink speed
  connection.downlinkMax