// Licensed to the Software Freedom Conservancy (SFC) under one // or more contributor license agreements. See the NOTICE file // distributed with this work for additional information // regarding copyright ownership. The SFC licenses this file // to you under the Apache License, Version 2.0 (the // "License"); you may not use this file except in compliance // with the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, // software distributed under the License is distributed on an // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY // KIND, either express or implied. See the License for the // specific language governing permissions and limitations // under the License. 'use strict'; var os = require('os'); function getLoInterface() { var name; if (process.platform === 'darwin') { name = 'lo0'; } else if (process.platform === 'linux') { name = 'lo'; } return name ? os.networkInterfaces()[name] : null; } /** * Queries the system network interfaces for an IP address. * @param {boolean} loopback Whether to find a loopback address. * @param {string=} opt_family The IP family (IPv4 or IPv6). Defaults to IPv4. * @return {string} The located IP address or undefined. */ function getAddress(loopback, opt_family) { var family = opt_family || 'IPv4'; var addresses = []; var interfaces; if (loopback) { var lo = getLoInterface(); interfaces = lo ? [lo] : null; } interfaces = interfaces || os.networkInterfaces(); for (var key in interfaces) { if (!interfaces.hasOwnProperty(key)) { continue; } interfaces[key].forEach(function(ipAddress) { if (ipAddress.family === family && ipAddress.internal === loopback) { addresses.push(ipAddress.address); } }); } return addresses[0]; } // PUBLIC API /** * Retrieves the external IP address for this host. * @param {string=} opt_family The IP family to retrieve. Defaults to "IPv4". * @return {string} The IP address or undefined if not available. */ exports.getAddress = function(opt_family) { return getAddress(false, opt_family); }; /** * Retrieves a loopback address for this machine. * @param {string=} opt_family The IP family to retrieve. Defaults to "IPv4". * @return {string} The IP address or undefined if not available. */ exports.getLoopbackAddress = function(opt_family) { return getAddress(true, opt_family); }; /** * Splits a hostport string, e.g. "www.example.com:80", into its component * parts. * * @param {string} hostport The string to split. * @return {{host: string, port: ?number}} A host and port. If no port is * present in the argument `hostport`, port is null. */ exports.splitHostAndPort = function(hostport) { let lastIndex = hostport.lastIndexOf(':'); if (lastIndex < 0) { return {host: hostport, port: null}; } let firstIndex = hostport.indexOf(':'); if (firstIndex != lastIndex && !hostport.includes('[')) { // Multiple colons but no brackets, so assume the string is an IPv6 address // with no port (e.g. "1234:5678:9:0:1234:5678:9:0"). return {host: hostport, port: null}; } let host = hostport.slice(0, lastIndex); if (host.startsWith('[') && host.endsWith(']')) { host = host.slice(1, -1); } let port = parseInt(hostport.slice(lastIndex + 1), 10); return {host, port}; };