File: HeaderUtilitiesTest.cs
Web Access
Project: src\src\Http\Headers\test\Microsoft.Net.Http.Headers.Tests.csproj (Microsoft.Net.Http.Headers.Tests)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Globalization;
using Microsoft.Extensions.Primitives;
 
namespace Microsoft.Net.Http.Headers;
 
public class HeaderUtilitiesTest
{
    private const string Rfc1123Format = "r";
 
    [Theory]
    [MemberData(nameof(TestValues))]
    public void ReturnsSameResultAsRfc1123String(DateTimeOffset dateTime, bool quoted)
    {
        var formatted = dateTime.ToString(Rfc1123Format);
        var expected = quoted ? $"\"{formatted}\"" : formatted;
        var actual = HeaderUtilities.FormatDate(dateTime, quoted);
 
        Assert.Equal(expected, actual);
    }
 
    public static TheoryData<DateTimeOffset, bool> TestValues
    {
        get
        {
            var data = new TheoryData<DateTimeOffset, bool>();
 
            var date = new DateTimeOffset(new DateTime(2018, 1, 1, 1, 1, 1));
 
            foreach (var quoted in new[] { true, false })
            {
                data.Add(date, quoted);
 
                for (var i = 1; i < 60; i++)
                {
                    data.Add(date.AddSeconds(i), quoted);
                    data.Add(date.AddMinutes(i), quoted);
                }
 
                for (var i = 1; i < DateTime.DaysInMonth(date.Year, date.Month); i++)
                {
                    data.Add(date.AddDays(i), quoted);
                }
 
                for (var i = 1; i < 11; i++)
                {
                    data.Add(date.AddMonths(i), quoted);
                }
 
                for (var i = 1; i < 5; i++)
                {
                    data.Add(date.AddYears(i), quoted);
                }
            }
 
            return data;
        }
    }
 
    [Theory]
    [InlineData("h=1", "h", 1)]
    [InlineData("directive1=3, directive2=10", "directive1", 3)]
    [InlineData("directive1   =45, directive2=80", "directive1", 45)]
    [InlineData("directive1=   89   , directive2=22", "directive1", 89)]
    [InlineData("directive1=   89   , directive2= 42", "directive2", 42)]
    [InlineData("directive1=   89   , directive= 42", "directive", 42)]
    [InlineData("directive1,,,,,directive2 = 42 ", "directive2", 42)]
    [InlineData("directive1=;,directive2 = 42 ", "directive2", 42)]
    [InlineData("directive1;;,;;,directive2 = 42 ", "directive2", 42)]
    [InlineData("directive1=value;q=0.6,directive2 = 42 ", "directive2", 42)]
    public void TryParseSeconds_Succeeds(string headerValues, string targetValue, int expectedValue)
    {
        TimeSpan? value;
        Assert.True(HeaderUtilities.TryParseSeconds(new StringValues(headerValues), targetValue, out value));
        Assert.Equal(TimeSpan.FromSeconds(expectedValue), value);
    }
 
    [Theory]
    [InlineData("", "")]
    [InlineData(null, null)]
    [InlineData("h=", "h")]
    [InlineData("directive1=, directive2=10", "directive1")]
    [InlineData("directive1   , directive2=80", "directive1")]
    [InlineData("h=10", "directive")]
    [InlineData("directive1", "directive")]
    [InlineData("directive1,,,,,,,", "directive")]
    [InlineData("h=directive", "directive")]
    [InlineData("directive1, directive2=80", "directive")]
    [InlineData("directive1=;, directive2=10", "directive1")]
    [InlineData("directive1;directive2=10", "directive2")]
    public void TryParseSeconds_Fails(string headerValues, string targetValue)
    {
        TimeSpan? value;
        Assert.False(HeaderUtilities.TryParseSeconds(new StringValues(headerValues), targetValue, out value));
    }
 
    [Theory]
    [InlineData(0)]
    [InlineData(1)]
    [InlineData(1234567890)]
    [InlineData(long.MaxValue)]
    public void FormatNonNegativeInt64_MatchesToString(long value)
    {
        Assert.Equal(value.ToString(CultureInfo.InvariantCulture), HeaderUtilities.FormatNonNegativeInt64(value));
    }
 
    [Theory]
    [InlineData(-1)]
    [InlineData(-1234567890)]
    [InlineData(long.MinValue)]
    public void FormatNonNegativeInt64_Throws_ForNegativeValues(long value)
    {
        Assert.Throws<ArgumentOutOfRangeException>(() => HeaderUtilities.FormatNonNegativeInt64(value));
    }
 
    [Theory]
    [InlineData(0)]
    [InlineData(1)]
    [InlineData(-1)]
    [InlineData(-1234567890)]
    [InlineData(1234567890)]
    [InlineData(long.MinValue)]
    [InlineData(long.MaxValue)]
    public void FormatInt64_MatchesToString(long value)
    {
        Assert.Equal(value.ToString(CultureInfo.InvariantCulture), HeaderUtilities.FormatInt64(value));
    }
 
    [Theory]
    [InlineData("h", "h", true)]
    [InlineData("h=", "h", true)]
    [InlineData("h=1", "h", true)]
    [InlineData("H", "h", true)]
    [InlineData("H=", "h", true)]
    [InlineData("H=1", "h", true)]
    [InlineData("h", "H", true)]
    [InlineData("h=", "H", true)]
    [InlineData("h=1", "H", true)]
    [InlineData("directive1, directive=10", "directive1", true)]
    [InlineData("directive1=, directive=10", "directive1", true)]
    [InlineData("directive1=3, directive=10", "directive1", true)]
    [InlineData("directive1   , directive=80", "directive1", true)]
    [InlineData("   directive1, directive=80", "directive1", true)]
    [InlineData("directive1   =45, directive=80", "directive1", true)]
    [InlineData("directive1=   89   , directive=22", "directive1", true)]
    [InlineData("directive1, directive", "directive", true)]
    [InlineData("directive1, directive=", "directive", true)]
    [InlineData("directive1, directive=10", "directive", true)]
    [InlineData("directive1=3, directive", "directive", true)]
    [InlineData("directive1=3, directive=", "directive", true)]
    [InlineData("directive1=3, directive=10", "directive", true)]
    [InlineData("directive1=   89   , directive= 42", "directive", true)]
    [InlineData("directive1=   89   , directive = 42", "directive", true)]
    [InlineData("directive1,,,,,directive2 = 42 ", "directive2", true)]
    [InlineData("directive1;;,;;,directive2 = 42 ", "directive2", true)]
    [InlineData("directive1=;,directive2 = 42 ", "directive2", true)]
    [InlineData("directive1=value;q=0.6,directive2 = 42 ", "directive2", true)]
    [InlineData(null, null, false)]
    [InlineData(null, "", false)]
    [InlineData("", null, false)]
    [InlineData("", "", false)]
    [InlineData("h=10", "directive", false)]
    [InlineData("directive1", "directive", false)]
    [InlineData("directive1,,,,,,,", "directive", false)]
    [InlineData("h=directive", "directive", false)]
    [InlineData("directive1, directive2=80", "directive", false)]
    [InlineData("directive1;, directive2=80", "directive", false)]
    [InlineData("directive1=value;q=0.6;directive2 = 42 ", "directive2", false)]
    public void ContainsCacheDirective_MatchesExactValue(string headerValues, string targetValue, bool contains)
    {
        Assert.Equal(contains, HeaderUtilities.ContainsCacheDirective(new StringValues(headerValues), targetValue));
    }
 
    [Theory]
    [InlineData("")]
    [InlineData(null)]
    [InlineData("-1")]
    [InlineData("a")]
    [InlineData("1.1")]
    [InlineData("9223372036854775808")] // long.MaxValue + 1
    public void TryParseNonNegativeInt64_Fails(string valueString)
    {
        long value = 1;
        Assert.False(HeaderUtilities.TryParseNonNegativeInt64(valueString, out value));
        Assert.Equal(0, value);
    }
 
    [Theory]
    [InlineData("0", 0)]
    [InlineData("9223372036854775807", 9223372036854775807)] // long.MaxValue
    public void TryParseNonNegativeInt64_Succeeds(string valueString, long expected)
    {
        long value = 1;
        Assert.True(HeaderUtilities.TryParseNonNegativeInt64(valueString, out value));
        Assert.Equal(expected, value);
    }
 
    [Theory]
    [InlineData("")]
    [InlineData(null)]
    [InlineData("-1")]
    [InlineData("a")]
    [InlineData("1.1")]
    [InlineData("1,000")]
    [InlineData("2147483648")] // int.MaxValue + 1
    public void TryParseNonNegativeInt32_Fails(string valueString)
    {
        int value = 1;
        Assert.False(HeaderUtilities.TryParseNonNegativeInt32(valueString, out value));
        Assert.Equal(0, value);
    }
 
    [Theory]
    [InlineData("0", 0)]
    [InlineData("2147483647", 2147483647)] // int.MaxValue
    public void TryParseNonNegativeInt32_Succeeds(string valueString, long expected)
    {
        int value = 1;
        Assert.True(HeaderUtilities.TryParseNonNegativeInt32(valueString, out value));
        Assert.Equal(expected, value);
    }
 
    [Theory]
    [InlineData("\"hello\"", "hello")]
    [InlineData("\"hello", "\"hello")]
    [InlineData("hello\"", "hello\"")]
    [InlineData("\"\"hello\"\"", "\"hello\"")]
    public void RemoveQuotes_BehaviorCheck(string input, string expected)
    {
        var actual = HeaderUtilities.RemoveQuotes(input);
 
        Assert.Equal(expected, actual);
    }
    [Theory]
    [InlineData("\"hello\"", true)]
    [InlineData("\"hello", false)]
    [InlineData("hello\"", false)]
    [InlineData("\"\"hello\"\"", true)]
    public void IsQuoted_BehaviorCheck(string input, bool expected)
    {
        var actual = HeaderUtilities.IsQuoted(input);
 
        Assert.Equal(expected, actual);
    }
 
    [Theory]
    [InlineData("value", "value")]
    [InlineData("\"value\"", "value")]
    [InlineData("\"hello\\\\\"", "hello\\")]
    [InlineData("\"hello\\\"\"", "hello\"")]
    [InlineData("\"hello\\\"foo\\\\bar\\\\baz\\\\\"", "hello\"foo\\bar\\baz\\")]
    [InlineData("\"quoted value\"", "quoted value")]
    [InlineData("\"quoted\\\"valuewithquote\"", "quoted\"valuewithquote")]
    [InlineData("\"hello\\\"", "hello\\")]
    public void UnescapeAsQuotedString_BehaviorCheck(string input, string expected)
    {
        var actual = HeaderUtilities.UnescapeAsQuotedString(input);
 
        Assert.Equal(expected, actual);
    }
 
    [Theory]
    [InlineData("value", "\"value\"")]
    [InlineData("23", "\"23\"")]
    [InlineData(";;;", "\";;;\"")]
    [InlineData("\"value\"", "\"\\\"value\\\"\"")]
    [InlineData("unquoted \"value", "\"unquoted \\\"value\"")]
    [InlineData("value\\morevalues\\evenmorevalues", "\"value\\\\morevalues\\\\evenmorevalues\"")]
    // We have to assume that the input needs to be quoted here
    [InlineData("\"\"double quoted string\"\"", "\"\\\"\\\"double quoted string\\\"\\\"\"")]
    [InlineData("\t", "\"\t\"")]
    public void SetAndEscapeValue_BehaviorCheck(string input, string expected)
    {
        var actual = HeaderUtilities.EscapeAsQuotedString(input);
 
        Assert.Equal(expected, actual);
    }
 
    [Theory]
    [InlineData("\n")]
    [InlineData("\b")]
    [InlineData("\r")]
    public void SetAndEscapeValue_ControlCharactersThrowFormatException(string input)
    {
        Assert.Throws<FormatException>(() => { var actual = HeaderUtilities.EscapeAsQuotedString(input); });
    }
 
    [Fact]
    public void SetAndEscapeValue_ThrowsFormatExceptionOnDelCharacter()
    {
        Assert.Throws<FormatException>(() => { var actual = HeaderUtilities.EscapeAsQuotedString($"{(char)0x7F}"); });
    }
 
    [Theory]
    [InlineData("text;q=0", 0d, 1)]
    [InlineData("text;q=1", 1d, 1)]
    public void TryParseQualityDouble_WithoutDecimalPart_ReturnsCorrectQuality(
        string inputString,
        double expectedQuality,
        int expectedLength)
        => VerifyTryParseQualityDoubleSuccess(inputString, 7, expectedQuality, expectedLength);
 
    [Theory]
    [InlineData("text;q=0,*;q=1", 0d, 1)]
    [InlineData("text;q=1,*;q=0", 1d, 1)]
    public void TryParseQualityDouble_WithoutDecimalPart_WithSubsequentCharacters_ReturnsCorrectQuality(
        string inputString,
        double expectedQuality,
        int expectedLength)
        => VerifyTryParseQualityDoubleSuccess(inputString, 7, expectedQuality, expectedLength);
 
    [Theory]
    [InlineData("text;q=0.", 0d, 2)]
    [InlineData("text;q=0.0", 0d, 3)]
    [InlineData("text;q=0.00000000", 0d, 10)]
    [InlineData("text;q=1.", 1d, 2)]
    [InlineData("text;q=1.0", 1d, 3)]
    [InlineData("text;q=1.000", 1d, 5)]
    [InlineData("text;q=1.00000000", 1d, 10)]
    [InlineData("text;q=0.1", 0.1d, 3)]
    [InlineData("text;q=0.001", 0.001d, 5)]
    [InlineData("text;q=0.00000001", 0.00000001d, 10)]
    [InlineData("text;q=0.12345678", 0.12345678d, 10)]
    [InlineData("text;q=0.98765432", 0.98765432d, 10)]
    public void TryParseQualityDouble_WithDecimalPart_ReturnsCorrectQuality(
        string inputString, double expectedQuality, int expectedLength)
        => VerifyTryParseQualityDoubleSuccess(inputString, 7, expectedQuality, expectedLength);
 
    [Theory]
    [InlineData("text;q=0.,*;q=1", 0d, 2)]
    [InlineData("text;q=0.0,*;q=1", 0d, 3)]
    [InlineData("text;q=0.00000000,*;q=1", 0d, 10)]
    [InlineData("text;q=1.,*;q=1", 1d, 2)]
    [InlineData("text;q=1.0,*;q=1", 1d, 3)]
    [InlineData("text;q=1.000,*;q=1", 1d, 5)]
    [InlineData("text;q=1.00000000,*;q=1", 1d, 10)]
    [InlineData("text;q=0.1,*;q=1", 0.1d, 3)]
    [InlineData("text;q=0.001,*;q=1", 0.001d, 5)]
    [InlineData("text;q=0.00000001,*;q=1", 0.00000001d, 10)]
    [InlineData("text;q=0.12345678,*;q=1", 0.12345678d, 10)]
    [InlineData("text;q=0.98765432,*;q=1", 0.98765432d, 10)]
    public void TryParseQualityDouble_WithDecimalPart_WithSubsequentCharacters_ReturnsCorrectQuality(
        string inputString, double expectedQuality, int expectedLength)
        => VerifyTryParseQualityDoubleSuccess(inputString, 7, expectedQuality, expectedLength);
 
    private static void VerifyTryParseQualityDoubleSuccess(string inputString, int startIndex, double expectedQuality, int expectedLength)
    {
        // Arrange
        var input = new StringSegment(inputString);
 
        // Act
        var result = HeaderUtilities.TryParseQualityDouble(input, startIndex, out var actualQuality, out var actualLength);
 
        // Assert
        Assert.True(result);
        Assert.Equal(expectedQuality, actualQuality);
        Assert.Equal(expectedLength, actualLength);
    }
 
    [Fact]
    public void TryParseQualityDouble_StartIndexIsOutOfRange_ReturnsFalse()
        => VerifyTryParseQualityDoubleFailure("text;q=0.1", 10);
 
    [Theory]
    [InlineData("text;q=2")]
    [InlineData("text;q=a")]
    [InlineData("text;q=.1")]
    [InlineData("text;q=/.1")]
    [InlineData("text;q=:.1")]
    public void TryParseQualityDouble_HasInvalidStartingCharacter_ReturnsFalse(string inputString)
        => VerifyTryParseQualityDoubleFailure(inputString, 7);
 
    [Theory]
    [InlineData("text;q=00")]
    [InlineData("text;q=00.")]
    [InlineData("text;q=00.0")]
    [InlineData("text;q=01.0")]
    [InlineData("text;q=10")]
    [InlineData("text;q=10.")]
    [InlineData("text;q=10.0")]
    [InlineData("text;q=11.0")]
    public void TryParseQualityDouble_HasMoreThanOneDigitBeforeDot_ReturnsFalse(string inputString)
        => VerifyTryParseQualityDoubleFailure(inputString, 7);
 
    [Theory]
    [InlineData("text;q=0.000000000")]
    [InlineData("text;q=1.000000000")]
    [InlineData("text;q=0.000000001")]
    public void TryParseQualityDouble_ExceedsQualityValueMaxCharacterCount_ReturnsFalse(string inputString)
        => VerifyTryParseQualityDoubleFailure(inputString, 7);
 
    [Theory]
    [InlineData("text;q=1.000000001")]
    [InlineData("text;q=2")]
    public void TryParseQualityDouble_ParsedQualityIsGreaterThanOne_ReturnsFalse(string inputString)
        => VerifyTryParseQualityDoubleFailure(inputString, 7);
 
    private static void VerifyTryParseQualityDoubleFailure(string inputString, int startIndex)
    {
        // Arrange
        var input = new StringSegment(inputString);
 
        // Act
        var result = HeaderUtilities.TryParseQualityDouble(input, startIndex, out var quality, out var length);
 
        // Assert
        Assert.False(result);
        Assert.Equal(0, quality);
        Assert.Equal(0, length);
    }
}