HarSharp

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 67)

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

HarSharp Latest Version Download

Download Latest Version (.zip)

// 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

HarSharp Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

HarSharp

HarSharp Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README