KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

HarSharp

★ 67 Open GitHub ↗

A small and easy-to-use library to parse HTTP Archive (HAR) format to .NET objects.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HarSharp
[![Build status](https://ci.appveyor.com/api/projects/status/xq94qa91esm7wq97?svg=true)](https://ci.appveyor.com/project/giacomelli/harsharp)
[![Quality status](https://sonarcloud.io/api/project_badges/measure?project=HarSharp&metric=alert_status)](https://sonarcloud.io/dashboard?id=HarSharp)
[![Coverage Status](https://sonarcloud.io/api/project_badges/measure?project=HarSharp&metric=coverage)](https://sonarcloud.io/dashboard?id=HarSharp)
[![License](http://img.shields.io/:license-MIT-blue.svg)](https://raw.githubusercontent.com/giacomelli/HarSharp/master/LICENSE)
[![Nuget](https://img.shields.io/nuget/v/HarSharp.svg)](https://www.nuget.org/packages/HarSharp/)

A small and easy-to-use library to parse HTTP Archive (HAR) format to .NET objects.

--------

## Introduction
The HTTP Archive (HAR) format as defined in the [W3C Specification](https://dvcs.w3.org/hg/webperf/raw-file/tip/specs/HAR/Overview.html) is an archival format for HTTP transactions that can be used by a web browser to export detailed performance data about web pages it loads.

So, every modern browser nowadays can export HAR with a lot of information about the user navigation. Chrome, for example, can export HAR from Developer Tools, Network tab, right mouse click and "Copy all as HAR".

What I can do with HAR data?
Well, there a lot of things I can imagine right now, like:
- Web performance tests runners
- Performance analyzers
- Navigation visualizers

## Setup

#### NuGet
```shell
install-package HarSharp
```

--------

## Usage
### Deserialize from string
```csharp
var har = HarConvert.Deserialize(harContent);
```

### Deserialize from file
```csharp
var har = HarConvert.DeserializeFromFile(fileName);
```

### Listing pages load time
```csharp
var har = HarConvert.Deserialize(harContent);

foreach(var page in har.Log.Pages)
{
	Console.WriteLine(
	"Page: {0} loaded in {1} milliseconds", 
	page.Title, 
	page.PageTimings.OnLoad);
}
```

## Code philosophy
The idea of HarSharp is simplify and promote the use of HAR in .NET codes and keep closest possible to [W3C specification](https://dvcs.w3.org/hg/webperf/raw-file/tip/specs/HAR/Overview.html) , for this reason the below rules were followed during the library development:
- Keep the entities and properties names equals to the one defined in the [specification](https://dvcs.w3.org/hg/webperf/raw-file/tip/specs/HAR/Overview.html), but follow the C# naming guidelines, so, "pages" became "Pages".
- Keep the properties types closest to the spec, but change when there is a better type on .NET side.
	- string (ISO 8601 - YYYY-MM-DDThh:mm:ss.sTZD): System.DateTime (UTC).
	- string (url): System.Uri.
- Full documentation using citations from W3C specification.
- StyleCop validation.
- FxCop Validation.
- 100% unit test coverage

## FAQ

#### Having troubles? 
 - Ask on [Stack Overflow](http://stackoverflow.com/search?q=HarSharp)

## Roadmap

- Serialize HAR entities back to HAR file.
 
--------

## How to improve it?
- Create a fork of [HarSharp](https://github.com/giacomelli/HarSharp/fork). 
- Did you change it? [Submit a pull request](https://github.com/giacomelli/HarSharp/pull/new/master).

## License

Licensed under the The MIT License (MIT).
In others words, you can use this library for developement any kind of software: open source, commercial, proprietary and alien.

HarSharp

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README