Have ideas to improve npm?Join in the discussion! »

TypeScript icon, indicating that this package has built-in type declarations

1.2.3 • Public • Published


Easy way to manipulate the hosts file contents.

Why this?

  • simple, lightweight
  • synchronous =>
    • less error prone over other library since they open the small file for very long time which may cause file corruption
    • ease of use, don't need to chain with Promise
  • support multiple hostname associated with a single IP address
  • well tested before release
  • transparent source code
  • free of use

What's news?

  • 1.1.0
    • Improve set() function to support new separate entry
  • 1.2.0
    • Fix the set() function to support modifying existed hostname
  • 1.2.1
    • Refactor the source code. Create SimpleHosts class supporting input hosts file path
    • Add test cases
    • Update document
  • 1.2.2
    • Use typescript
  • 1.2.3
    • Support remove records by IP or hostname with removeIp() and removeHost() function

This package provides the below synchronous functions

  1. Get corresponding IP of a hostname

    getIp(hostname: string): string

    Returns the corresponding IP that is mapped to the input hostname. If no record is found, it will return an empty string. If there are multiple IPs that are mapped to a same hostname, the first IP will be returned. Multiple IPs for a same hostname is not encouraged because it causes ambiguous

  2. Get corresponding hostnames of an IP

    getHosts(ip: string): string[]

    Returns an array of found hostnames that are mapped to the input IP

  3. Create or modify a record in hosts file

    set(ip: string, hostname: string): void

    If the same record that contains same IP and same hostname has been in the hosts file, no additional writing is performed. If the hostname has been already existed, it will be removed from the map of current IP and then new record will be added.

  4. Remove records by ID address

    removeIp(ip: string): void
  5. Remove records by hostname

    removeHost(hostname: string): void



npm i simple-hosts

DownloadsWeekly Downloads






Unpacked Size

25.1 kB

Total Files


Last publish


  • avatar