class Nokogiri::CSS::Parser - nokogiri-1.10.3 Documentation

# class Nokogiri::CSS::Parser

### Constants

Racc_arg
Racc_debug_parser
Racc_token_to_s_table

### Attributes

cache_on[RW]

Turn on CSS parse caching

cache_on?[RW]

Turn on CSS parse caching

set_cache[RW]

Turn on CSS parse caching

### Public Class Methods

[](string) click to toggle source

Get the css selector in `string` from the cache

    # File lib/nokogiri/css/parser_extras.rb, line 17
    def [] string
      return unless @cache_on
      @mutex.synchronize { @cache[string] }
    end

[]=(string, value) click to toggle source

Set the css selector in `string` in the cache to `value`

    # File lib/nokogiri/css/parser_extras.rb, line 23
    def []= string, value
      return value unless @cache_on
      @mutex.synchronize { @cache[string] = value }
    end

clear_cache() click to toggle source

Clear the cache

    # File lib/nokogiri/css/parser_extras.rb, line 29
    def clear_cache
      @mutex.synchronize { @cache = {} }
    end

new(namespaces = {}) click to toggle source

Create a new CSS parser with respect to `namespaces`

Calls superclass method

    # File lib/nokogiri/css/parser_extras.rb, line 54
    def initialize namespaces = {}
      @tokenizer  = Tokenizer.new
      @namespaces = namespaces
      super()
    end

parse(selector) click to toggle source

Parse this CSS selector in `selector`. Returns an AST.

    # File lib/nokogiri/css/parser_extras.rb, line 43
    def parse selector
      @warned ||= false
      unless @warned
        $stderr.puts('Nokogiri::CSS::Parser.parse is deprecated, call Nokogiri::CSS.parse(), this will be removed August 1st or version 1.4.0 (whichever is first)')
        @warned = true
      end
      new.parse selector
    end

without_cache(&block) click to toggle source

Execute `block` without cache

    # File lib/nokogiri/css/parser_extras.rb, line 34
    def without_cache &block
      tmp = @cache_on
      @cache_on = false
      block.call
      @cache_on = tmp
    end

### Public Instance Methods

_reduce_1(val, _values, result) click to toggle source

reduce 0 omitted

    # File lib/nokogiri/css/parser.rb, line 334
    def _reduce_1(val, _values, result)
            result = [val.first, val.last].flatten

        result
    end

_reduce_11(val, _values, result) click to toggle source

reduce 10 omitted

    # File lib/nokogiri/css/parser.rb, line 387
    def _reduce_11(val, _values, result)
            result = Node.new(:CONDITIONAL_SELECTOR, val)

        result
    end

_reduce_12(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 393
    def _reduce_12(val, _values, result)
            result = Node.new(:CONDITIONAL_SELECTOR, val)

        result
    end

_reduce_13(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 399
    def _reduce_13(val, _values, result)
            result = Node.new(:CONDITIONAL_SELECTOR,
              [Node.new(:ELEMENT_NAME, ['*']), val.first]
            )

        result
    end

_reduce_14(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 407
    def _reduce_14(val, _values, result)
            result = Node.new(val.first, [nil, val.last])

        result
    end

_reduce_15(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 413
    def _reduce_15(val, _values, result)
            result = Node.new(val[1], [val.first, val.last])

        result
    end

_reduce_16(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 419
    def _reduce_16(val, _values, result)
            result = Node.new(:DESCENDANT_SELECTOR, [val.first, val.last])

        result
    end

_reduce_18(val, _values, result) click to toggle source

reduce 17 omitted

    # File lib/nokogiri/css/parser.rb, line 427
    def _reduce_18(val, _values, result)
     result = Node.new(:CLASS_CONDITION, [unescape_css_identifier(val[1])])
        result
    end

_reduce_2(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 340
    def _reduce_2(val, _values, result)
     result = val.flatten
        result
    end

_reduce_20(val, _values, result) click to toggle source

reduce 19 omitted

    # File lib/nokogiri/css/parser.rb, line 434
    def _reduce_20(val, _values, result)
     result = Node.new(:ELEMENT_NAME, val)
        result
    end

_reduce_21(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 439
    def _reduce_21(val, _values, result)
            result = Node.new(:ELEMENT_NAME,
              [[val.first, val.last].compact.join(':')]
            )

        result
    end

_reduce_22(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 447
    def _reduce_22(val, _values, result)
            name = @namespaces.key?('xmlns') ? "xmlns:#{val.first}" : val.first
            result = Node.new(:ELEMENT_NAME, [name])

        result
    end

_reduce_23(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 454
    def _reduce_23(val, _values, result)
     result = val[0]
        result
    end

_reduce_25(val, _values, result) click to toggle source

reduce 24 omitted

    # File lib/nokogiri/css/parser.rb, line 461
    def _reduce_25(val, _values, result)
            result = Node.new(:ATTRIBUTE_CONDITION,
              [val[1]] + (val[2] || [])
            )

        result
    end

_reduce_26(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 469
    def _reduce_26(val, _values, result)
            result = Node.new(:ATTRIBUTE_CONDITION,
              [val[1]] + (val[2] || [])
            )

        result
    end

_reduce_27(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 477
    def _reduce_27(val, _values, result)
            # Non standard, but hpricot supports it.
            result = Node.new(:PSEUDO_CLASS,
              [Node.new(:FUNCTION, ['nth-child(', val[1]])]
            )

        result
    end

_reduce_28(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 486
    def _reduce_28(val, _values, result)
            result = Node.new(:ELEMENT_NAME,
              [[val.first, val.last].compact.join(':')]
            )

        result
    end

_reduce_29(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 494
    def _reduce_29(val, _values, result)
            # Default namespace is not applied to attributes.
            # So we don't add prefix "xmlns:" as in namespaced_ident.
            result = Node.new(:ELEMENT_NAME, [val.first])

        result
    end

_reduce_3(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 345
    def _reduce_3(val, _values, result)
     result = [val.last].flatten
        result
    end

_reduce_30(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 502
    def _reduce_30(val, _values, result)
            result = Node.new(:FUNCTION, [val.first.strip])

        result
    end

_reduce_31(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 508
    def _reduce_31(val, _values, result)
            result = Node.new(:FUNCTION, [val.first.strip, val[1]].flatten)

        result
    end

_reduce_32(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 514
    def _reduce_32(val, _values, result)
            result = Node.new(:FUNCTION, [val.first.strip, val[1]].flatten)

        result
    end

_reduce_33(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 520
    def _reduce_33(val, _values, result)
            result = Node.new(:FUNCTION, [val.first.strip, val[1]].flatten)

        result
    end

_reduce_34(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 526
    def _reduce_34(val, _values, result)
            result = Node.new(:FUNCTION, [val.first.strip, val[1]].flatten)

        result
    end

_reduce_35(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 532
    def _reduce_35(val, _values, result)
     result = [val.first, val.last]
        result
    end

_reduce_36(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 537
    def _reduce_36(val, _values, result)
     result = [val.first, val.last]
        result
    end

_reduce_37(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 542
    def _reduce_37(val, _values, result)
     result = [val.first, val.last]
        result
    end

_reduce_4(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 350
    def _reduce_4(val, _values, result)
     result = :DIRECT_ADJACENT_SELECTOR
        result
    end

_reduce_40(val, _values, result) click to toggle source

reduce 39 omitted

    # File lib/nokogiri/css/parser.rb, line 551
    def _reduce_40(val, _values, result)
            case val[0]
            when 'even'
              result = Node.new(:NTH, ['2','n','+','0'])
            when 'odd'
              result = Node.new(:NTH, ['2','n','+','1'])
            when 'n'
              result = Node.new(:NTH, ['1','n','+','0'])
            else
              # This is not CSS standard.  It allows us to support this:
              # assert_xpath("//a[foo(., @href)]", @parser.parse('a:foo(@href)'))
              # assert_xpath("//a[foo(., @a, b)]", @parser.parse('a:foo(@a, b)'))
              # assert_xpath("//a[foo(., a, 10)]", @parser.parse('a:foo(a, 10)'))
              result = val
            end

        result
    end

_reduce_41(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 570
    def _reduce_41(val, _values, result)
            if val[1] == 'n'
              result = Node.new(:NTH, val)
            else
              raise Racc::ParseError, "parse error on IDENT '#{val[1]}'"
            end

        result
    end

_reduce_42(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 580
    def _reduce_42(val, _values, result)
                   # n+3, -n+3
            if val[0] == 'n'
              val.unshift("1")
              result = Node.new(:NTH, val)
            elsif val[0] == '-n'
              val[0] = 'n'
              val.unshift("-1")
              result = Node.new(:NTH, val)
            else
              raise Racc::ParseError, "parse error on IDENT '#{val[1]}'"
            end

        result
    end

_reduce_43(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 596
    def _reduce_43(val, _values, result)
                        # 5n, -5n, 10n-1
            n = val[1]
            if n[0, 2] == 'n-'
              val[1] = 'n'
              val << "-"
              # b is contained in n as n is the string "n-b"
              val << n[2, n.size]
              result = Node.new(:NTH, val)
            elsif n == 'n'
              val << "+"
              val << "0"
              result = Node.new(:NTH, val)
            else
              raise Racc::ParseError, "parse error on IDENT '#{val[1]}'"
            end

        result
    end

_reduce_44(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 616
    def _reduce_44(val, _values, result)
            result = Node.new(:PSEUDO_CLASS, [val[1]])

        result
    end

_reduce_45(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 622
    def _reduce_45(val, _values, result)
     result = Node.new(:PSEUDO_CLASS, [val[1]])
        result
    end

_reduce_48(val, _values, result) click to toggle source

reduce 47 omitted

    # File lib/nokogiri/css/parser.rb, line 631
    def _reduce_48(val, _values, result)
            result = Node.new(:COMBINATOR, val)

        result
    end

_reduce_49(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 637
    def _reduce_49(val, _values, result)
            result = Node.new(:COMBINATOR, val)

        result
    end

_reduce_5(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 355
    def _reduce_5(val, _values, result)
     result = :CHILD_SELECTOR
        result
    end

_reduce_50(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 643
    def _reduce_50(val, _values, result)
            result = Node.new(:COMBINATOR, val)

        result
    end

_reduce_51(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 649
    def _reduce_51(val, _values, result)
            result = Node.new(:COMBINATOR, val)

        result
    end

_reduce_52(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 655
    def _reduce_52(val, _values, result)
            result = Node.new(:COMBINATOR, val)

        result
    end

_reduce_58(val, _values, result) click to toggle source

reduce 57 omitted

    # File lib/nokogiri/css/parser.rb, line 671
    def _reduce_58(val, _values, result)
     result = Node.new(:ID, [unescape_css_identifier(val.first)])
        result
    end

_reduce_59(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 676
    def _reduce_59(val, _values, result)
     result = [val.first, unescape_css_identifier(val[1])]
        result
    end

_reduce_6(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 360
    def _reduce_6(val, _values, result)
     result = :FOLLOWING_SELECTOR
        result
    end

_reduce_60(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 681
    def _reduce_60(val, _values, result)
     result = [val.first, unescape_css_string(val[1])]
        result
    end

_reduce_61(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 686
    def _reduce_61(val, _values, result)
     result = [val.first, val[1]]
        result
    end

_reduce_63(val, _values, result) click to toggle source

reduce 62 omitted

    # File lib/nokogiri/css/parser.rb, line 693
    def _reduce_63(val, _values, result)
     result = :equal
        result
    end

_reduce_64(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 698
    def _reduce_64(val, _values, result)
     result = :prefix_match
        result
    end

_reduce_65(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 703
    def _reduce_65(val, _values, result)
     result = :suffix_match
        result
    end

_reduce_66(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 708
    def _reduce_66(val, _values, result)
     result = :substring_match
        result
    end

_reduce_67(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 713
    def _reduce_67(val, _values, result)
     result = :not_equal
        result
    end

_reduce_68(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 718
    def _reduce_68(val, _values, result)
     result = :includes
        result
    end

_reduce_69(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 723
    def _reduce_69(val, _values, result)
     result = :dash_match
        result
    end

_reduce_7(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 365
    def _reduce_7(val, _values, result)
     result = :DESCENDANT_SELECTOR
        result
    end

_reduce_70(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 728
    def _reduce_70(val, _values, result)
            result = Node.new(:NOT, [val[1]])

        result
    end

_reduce_8(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 370
    def _reduce_8(val, _values, result)
     result = :CHILD_SELECTOR
        result
    end

_reduce_9(val, _values, result) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 375
    def _reduce_9(val, _values, result)
            result =  if val[1].nil?
                        val.first
                      else
                        Node.new(:CONDITIONAL_SELECTOR, [val.first, val[1]])
                      end

        result
    end

_reduce_none(val, _values, result) click to toggle source

reduce 75 omitted

    # File lib/nokogiri/css/parser.rb, line 744
    def _reduce_none(val, _values, result)
      val[0]
    end

next_token() click to toggle source

    # File lib/nokogiri/css/parser_extras.rb, line 65
    def next_token
      @tokenizer.next_token
    end

on_error(error_token_id, error_value, value_stack) click to toggle source

On CSS parser error, raise an exception

    # File lib/nokogiri/css/parser_extras.rb, line 85
    def on_error error_token_id, error_value, value_stack
      after = value_stack.compact.last
      raise SyntaxError.new("unexpected '#{error_value}' after '#{after}'")
    end

parse(string) click to toggle source

    # File lib/nokogiri/css/parser_extras.rb, line 60
    def parse string
      @tokenizer.scan_setup string
      do_parse
    end

unescape_css_identifier(identifier) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 17
    def unescape_css_identifier(identifier)
      identifier.gsub(/\\(?:([^0-9a-fA-F])|([0-9a-fA-F]{1,6})\s?)/){ |m| $1 || [$2.hex].pack('U') }
    end

unescape_css_string(str) click to toggle source

    # File lib/nokogiri/css/parser.rb, line 21
    def unescape_css_string(str)
      str.gsub(/\\(?:([^0-9a-fA-F])|([0-9a-fA-F]{1,6})\s?)/) do |m|
        if $1=="\n"
          ''
        else
          $1 || [$2.hex].pack('U')
        end
      end
    end

xpath_for(string, options={}) click to toggle source

Get the xpath for `string` using `options`

    # File lib/nokogiri/css/parser_extras.rb, line 70
    def xpath_for string, options={}
      key = "#{string}#{options[:ns]}#{options[:prefix]}"
      v = self.class[key]
      return v if v

      args = [
        options[:prefix] || '//',
        options[:visitor] || XPathVisitor.new
      ]
      self.class[key] = parse(string).map { |ast|
        ast.to_xpath(*args)
      }
    end