useragent

README

useragent

A comprehensive and categorized collection of User Agents.

Installation Instructions

To install the useragent tool, use the following command:

go install -v github.com/projectdiscovery/useragent/cmd/ua@latest

Usage

To display help for the tool, use the following command:

ua -h

This will display all the flags supported by the tool:

ua is a straightforward tool to query and filter user agents

Usage:
  ./ua [flags]

Flags:
   -list              list all the categorized tags of user-agent
   -l, -limit int     number of user-agent to list (use -1 to list all) (default 10)
   -t, -tag string[]  list user-agent for given tag

The useragent tool is designed to be simple and efficient, making it easy to query and filter user agents based on your specific needs.

Credits

This tool utilizes user agent data obtained from WhatIsMyBrowser.com.

Documentation

Index

• Variables
• func Apple(userAgent *UserAgent) bool
• func Bot(userAgent *UserAgent) bool
• func Chrome(userAgent *UserAgent) bool
• func Computer(userAgent *UserAgent) bool
• func ContainsTags(userAgent *UserAgent, tags ...string) bool
• func ContainsTagsAny(userAgent *UserAgent, tags ...string) bool
• func GoogleBot(userAgent *UserAgent) bool
• func Legacy(userAgent *UserAgent) bool
• func Mobile(userAgent *UserAgent) bool
• func Mozilla(userAgent *UserAgent) bool
• func Safari(userAgent *UserAgent) bool
• func Windows(userAgent *UserAgent) bool
• type Filter
• type UserAgent
  • func Pick(n int) ([]*UserAgent, error)
  • func PickRandom() *UserAgent
  • func PickWithFilters(n int, filters ...Filter) ([]*UserAgent, error)
  • func (userAgent *UserAgent) String() string

Variables

var FilterMap map[string]Filter

FilterMap contains filter and its respective function signature

var UserAgents []*UserAgent

UserAgents of the package

Functions

func Apple

func Apple(userAgent *UserAgent) bool

Apple checks if the user agent has typical apple tags

func Bot

func Bot(userAgent *UserAgent) bool

Bot checks if the user agent has typical bot tags

func Chrome

func Chrome(userAgent *UserAgent) bool

Chrome checks if the user agent has typical chrome tags

func Computer

func Computer(userAgent *UserAgent) bool

Computer checks if the user agent has typical computer tags

func ContainsTags

func ContainsTags(userAgent *UserAgent, tags ...string) bool

ContainsTags returns true if the user agent contains all provided tags

func ContainsTagsAny

func ContainsTagsAny(userAgent *UserAgent, tags ...string) bool

ContainsTagsAny returns true if the user agent contains any of the provided tags

func GoogleBot

func GoogleBot(userAgent *UserAgent) bool

Google Checks if the user agent has typical GoogleBot tags

func Legacy

func Legacy(userAgent *UserAgent) bool

Legacy checks if the user agent falls under legacy category

func Mobile

func Mobile(userAgent *UserAgent) bool

Mobile checks if the user agent has typical mobile tags

func Mozilla

func Mozilla(userAgent *UserAgent) bool

Mozilla checks if the user agent has typical mozilla firefox tags

func Safari

func Safari(userAgent *UserAgent) bool

Safari checks if the user agent has typical safari tags

func Windows

func Windows(userAgent *UserAgent) bool

Windows checks if the user agent has typical windows tags

Types

type Filter

type Filter func(*UserAgent) bool

Filter represent the function signature for a filter

type UserAgent

type UserAgent struct {
	Tags []string
	Raw  string
}

UserAgent with tags

func Pick

func Pick(n int) ([]*UserAgent, error)

Pick n items randomly from the available ones

func PickRandom

func PickRandom() *UserAgent

func PickWithFilters

func PickWithFilters(n int, filters ...Filter) ([]*UserAgent, error)

Pick n items randomly for the available ones with optional filtering

func (*UserAgent) String

func (userAgent *UserAgent) String() string

String returns the user agent raw value